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

# Site status

> See which sources passed their last checks. Send one request and get JSON back. Examples in cURL, TypeScript and Python.

> [!NOTE]
>
> Needs no API key.

## Price

Free, and needs no key.

See [Pricing](https://docs.stophy.dev/account/pricing.md).

```bash cURL theme={null}
curl https://api.stophy.dev/v1/status
```

```typescript TypeScript theme={null}
const response = await fetch("https://api.stophy.dev/v1/status");
console.log(await response.json());
```

```python Python theme={null}
import requests

response = requests.get(
    "https://api.stophy.dev/v1/status",
)
print(response.json())
```

```json 200 theme={null}
{
  "sources": [
    {
      "failing": [
        "airbnb.listing"
      ],
      "id": "airbnb",
      "lastCheckAt": "2026-11-17T13:34:38.677Z",
      "medianMs": 693,
      "name": "airbnb",
      "passed": 2,
      "state": "partial",
      "total": 3
    }
  ],
  "updatedAt": "2026-11-17T13:35:51.437Z"
}
```


## OpenAPI

````yaml api-reference/openapi.json GET /v1/status
openapi: 3.1.0
info:
  title: Stophy API
  version: '1'
  description: >-
    Each operation shows its method and its input: a JSON object body, path and
    query parameters, or a file upload.


    Responses leave out empty values: null, empty strings, empty objects and
    empty nested lists are not sent.


    Text comes back whole. To get shorter responses, add
    ?maxTextLength=<characters> to the URL. Every text value longer than that is
    cut and ends with …. A screenshot is never cut, and a page whose text was
    cut has isTruncated set to true.


    x-cost-usd is what one call costs, in dollars. Every call costs the same,
    whatever it returns, unless an operation's description says it costs per 10
    results, or per hour of audio. Then x-cost-usd is the lowest price and
    x-cost-usd-max the most one call can cost. Where an operation takes limit,
    send it to return fewer results and pay for fewer.


    When a response has a cursor, send it back unchanged with the same input to
    get the next page. When it has a page, send the next page number.
servers:
  - url: https://api.stophy.dev
security:
  - apiKey: []
paths:
  /v1/status:
    get:
      summary: See which sources passed their last checks.
      description: Free, and needs no key.
      operationId: siteStatus
      responses:
        '200':
          description: Each source's last checks.
          content:
            application/json:
              schema:
                type: object
                properties:
                  sources:
                    type: array
                    items:
                      type: object
                      properties:
                        failing:
                          type: array
                          items:
                            type: string
                        id:
                          type: string
                        lastCheckAt:
                          type: string
                        medianMs:
                          type: number
                        name:
                          type: string
                        passed:
                          type: integer
                          minimum: -9007199254740991
                          maximum: 9007199254740991
                        state:
                          type: string
                          enum:
                            - up
                            - partial
                            - down
                        total:
                          type: integer
                          minimum: -9007199254740991
                          maximum: 9007199254740991
                      required:
                        - failing
                        - id
                        - lastCheckAt
                        - medianMs
                        - name
                        - passed
                        - state
                        - total
                  updatedAt:
                    anyOf:
                      - type: string
                      - type: 'null'
                required:
                  - sources
                  - updatedAt
        4XX:
          $ref: '#/components/responses/Error'
        5XX:
          $ref: '#/components/responses/Error'
      security: []
components:
  responses:
    Error:
      description: The request failed. Retry-After says when trying again can help.
      headers:
        X-Request-ID:
          $ref: '#/components/headers/RequestId'
        Retry-After:
          $ref: '#/components/headers/RetryAfter'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  headers:
    RequestId:
      description: The request id. Quote it when you report a problem.
      schema:
        type: string
    RetryAfter:
      description: Seconds to wait before retrying.
      schema:
        type: integer
  schemas:
    Error:
      type: object
      required:
        - success
        - error
        - code
      properties:
        success:
          const: false
        error:
          type: string
          description: What went wrong and what to do next.
        code:
          type: string
          enum:
            - apiKeyRequired
            - busy
            - checkRunning
            - cliSessionCompleted
            - cliSessionExists
            - cliSessionNotFound
            - forbidden
            - freeLimit
            - insufficientCredits
            - internalError
            - inviteClaimed
            - inviteDisabled
            - inviteExpired
            - inviteUsedUp
            - invalidCliSession
            - invalidCliVerifier
            - invalidRequest
            - jobFinished
            - methodNotAllowed
            - notFound
            - payloadTooLarge
            - profileBusy
            - profileTooLarge
            - prohibitedPermission
            - promptInjectionDetected
            - rateLimited
            - sourceChanged
            - sourceRefused
            - siteNotRead
            - sourceTimeout
            - sourceUnavailable
            - unauthorized
            - unsupportedMediaType
        retryable:
          type: boolean
          description: true when trying again can help.
        retryAfterSeconds:
          type: integer
        requestId:
          type: string
        requiredCredits:
          type: number
          description: >-
            Older field: the most the call can cost, in $0.002 steps. Sent when
            the balance is too low.
        availableCredits:
          type: number
          description: 'Older field: the balance in $0.002 steps. Sent with requiredCredits.'
        requiredUsd:
          type: number
          description: >-
            The most the call can cost, in dollars. Sent when the balance is too
            low.
        availableUsd:
          type: number
          description: What is left on the account, in dollars. Sent with requiredUsd.
        billingUrl:
          type: string
          description: Where to add money. Sent with requiredUsd.
        signupUrl:
          type: string
          const: https://stophy.dev/signup
          description: >-
            Where a person gets a key. Sent with apiKeyRequired, freeLimit and
            an invalid key.
        signup:
          type: string
          const: POST https://api.stophy.dev/v1/signup
          description: >-
            The call that gets an agent a key with no human. Sent next to
            signupUrl.
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer

````

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