> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socialquery.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Public service status

> Free passive status for every catalogued platform and non-operational operation. No API key, provider call or credit use. Missing adapters/credentials/routes are unavailable. Configured paths need at least three uncached successful or server-failed requests in the previous 30 minutes before operational status; 50%/90% failure shares yield degraded/down. Insufficient evidence is explicitly degraded, not evidence of an outage. Shared-method paths cannot be independently certified. Upstream API versions and circuit states are unknown. Responses can be cached for 30 seconds. GET only; no query parameters. The /v1/meta/status alias wraps the same data in the usual SocialQuery envelope.

Read service status without an API key or credits. This makes **no provider calls**. The response is bare JSON; `/v1/meta/status` wraps the same snapshot in the regular SocialQuery envelope for MCP and skill clients.

```bash theme={null}
curl https://socialquery.dev/v1/status
```

Every platform is included. Its `endpoints` list contains non-operational operations and a reason:

| Reason | Meaning |
| - | - |
| `route_unavailable` | No implemented, credentialed and policy-allowed route is configured. |
| `insufficient_recent_evidence` | Fewer than three uncached relevant requests occurred within 30 minutes. This is not proof of an outage. |
| `recent_failure_rate` | At least three observations exist and server failures reached 50% (degraded) or 90% (down). |
| `method_evidence_unavailable` | Logs aggregate a shared path without distinguishing HTTP methods. A successful GET cannot certify POST. |

A configured path can be operational only with enough recent evidence and less than 50% server failures. Cache hits, caller validation/authentication errors and not-found responses are excluded. An entirely operational platform is operational; an entirely unavailable platform is down; mixed states are degraded. Overall status is operational only when all platforms are operational.

This deliberately conservative snapshot is **not active monitoring or an uptime guarantee**. Trial exhaustion and upstream changes can still affect the next request. `upstreamVersions` is empty and `circuit_breaker_observed` is false because those observations are unavailable. `updated_at` records snapshot generation, not a provider update time. Shared storage and CDN caching can retain the response for 30 seconds.

No account IDs, request IDs, input queries, credentials or request counts are published. Origin reads are limited to 60 per minute per IP. Invalid query parameters return 422; non-GET requests return 405; unavailable status storage returns 503 without claiming health.

MCP: use `get_service_status` without credentials. Python skill: run `socialquery_api.py status`.


## OpenAPI

````yaml GET /status
openapi: 3.1.0
info:
  title: SocialQuery API
  version: '2026-10-09'
  description: >-
    Documented requests for public-source records. Inspect accepted inputs and
    credit amounts, then verify the selected operation before integrating
    preview coverage.
servers:
  - url: https://socialquery.dev/v1
security:
  - apiKey: []
paths:
  /status:
    get:
      tags:
        - meta
      summary: Public service status
      description: >-
        Free passive status for every catalogued platform and non-operational
        operation. No API key, provider call or credit use. Missing
        adapters/credentials/routes are unavailable. Configured paths need at
        least three uncached successful or server-failed requests in the
        previous 30 minutes before operational status; 50%/90% failure shares
        yield degraded/down. Insufficient evidence is explicitly degraded, not
        evidence of an outage. Shared-method paths cannot be independently
        certified. Upstream API versions and circuit states are unknown.
        Responses can be cached for 30 seconds. GET only; no query parameters.
        The /v1/meta/status alias wraps the same data in the usual SocialQuery
        envelope.
      operationId: meta_status
      parameters: []
      responses:
        '200':
          description: >-
            Passive status snapshot; bare JSON rather than a charged-data
            envelope.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - operational
                      - degraded
                  platforms:
                    type: object
                    additionalProperties:
                      type: object
                      properties:
                        status:
                          type: string
                          enum:
                            - operational
                            - degraded
                            - down
                        endpoints:
                          type: array
                          items:
                            type: object
                            properties:
                              method:
                                type: string
                              path:
                                type: string
                              status:
                                type: string
                                enum:
                                  - degraded
                                  - down
                              reason:
                                type: string
                                enum:
                                  - route_unavailable
                                  - recent_failure_rate
                                  - method_evidence_unavailable
                                  - insufficient_recent_evidence
                            required:
                              - method
                              - path
                              - status
                              - reason
                            additionalProperties: false
                      required:
                        - status
                        - endpoints
                      additionalProperties: false
                  upstreamVersions:
                    type: object
                    additionalProperties: false
                    description: >-
                      Empty: actual upstream version distribution is not
                      recorded.
                  updated_at:
                    type: string
                    format: date-time
                  route_version:
                    type: string
                  observation_window_minutes:
                    type: integer
                    const: 30
                  minimum_observations:
                    const: 3
                    type: integer
                  circuit_breaker_observed:
                    type: boolean
                    const: false
                  coverage_note:
                    type: string
                required:
                  - status
                  - platforms
                  - upstreamVersions
                  - updated_at
                  - route_version
                  - observation_window_minutes
                  - minimum_observations
                  - circuit_breaker_observed
                  - coverage_note
                additionalProperties: false
        '405':
          description: Use GET.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SocialQueryError'
        '422':
          description: Query parameters are not accepted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SocialQueryError'
        '429':
          description: Public status rate limit; retry after 60 seconds.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SocialQueryError'
        '503':
          description: Storage or rate limiter unavailable; no status claim.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SocialQueryError'
      security: []
components:
  schemas:
    SocialQueryError:
      type: object
      required:
        - success
        - platform
        - endpoint
        - credits_used
        - credits_remaining
        - request_id
        - cached
        - error
      properties:
        success:
          type: boolean
          const: false
        platform:
          type: string
        endpoint:
          type: string
        credits_used:
          type: integer
          minimum: 0
        credits_remaining:
          type:
            - integer
            - 'null'
        request_id:
          type: string
        cached:
          type: boolean
        error:
          type: object
          required:
            - code
            - type
            - message
            - status
            - doc_url
          properties:
            code:
              type: string
            type:
              type: string
            message:
              type: string
            status:
              type: integer
            doc_url:
              type: string
              format: uri
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.