> ## 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.

# Endpoint catalog API

> List every Stophy endpoint with its input schema, credit cost, and whether it works without a key. Use it to pick the right call.

* **Cost:** Free.

Use this catalog to find the right endpoint and its input. Send your API key with every request.


## OpenAPI

````yaml api-reference/openapi.json GET /v1/endpoints
openapi: 3.1.0
info:
  title: Stophy API
  version: '1'
  description: >-
    Every endpoint is a POST that takes its input as a JSON object body. Unknown
    fields are rejected with 400.


    Send Accept: text/markdown to get markdown instead of JSON.


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


    x-credits is what one call costs. When x-per-items is set, a call costs
    x-credits for every x-per-items items it returns, and at least x-credits.


    When a response has a cursor, send it back with the same input to get the
    next page.
servers:
  - url: https://api.stophy.dev
security:
  - apiKey: []
paths:
  /v1/endpoints:
    get:
      summary: List every endpoint with its cost and input schema.
      operationId: listEndpoints
      responses:
        '200':
          description: The endpoint catalog.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EndpointCatalog'
      security: []
components:
  schemas:
    EndpointCatalog:
      type: object
      required:
        - endpoints
        - sources
      properties:
        sources:
          type: array
          items:
            type: object
            required:
              - id
              - summary
            properties:
              id:
                type: string
              summary:
                type: string
                description: What you can get from this source.
        endpoints:
          type: array
          items:
            type: object
            required:
              - id
              - summary
              - method
              - path
              - credits
              - keyless
              - perItems
              - cacheTtlSeconds
              - example
            properties:
              id:
                type: string
              summary:
                type: string
                description: What this endpoint returns, in one line.
              method:
                const: POST
              path:
                type: string
              credits:
                type: integer
              keyless:
                type: boolean
              perItems:
                type:
                  - integer
                  - 'null'
              cacheTtlSeconds:
                type: integer
              input:
                type: object
                description: The endpoint's input as JSON Schema.
              example:
                type:
                  - object
                  - 'null'
                description: A real input for this endpoint, or null when there is none.
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer

````