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

# List Endpoints

> List the currently exposed gateway endpoint IDs and a small sample of recent public model IDs.

Returns a lightweight discovery payload for tooling or operator workflows that need to know which public endpoint families are currently exposed.

The response includes:

* `endpoints`: the canonical gateway endpoint IDs currently surfaced by the API
* `sample_models`: up to 10 recent visible model IDs from the public catalogue


## OpenAPI

````yaml GET /endpoints
openapi: 3.0.3
info:
  title: AI Stats Gateway API
  description: >-
    A gateway API for accessing various AI models with OpenAI-compatible
    endpoints.
  version: 1.0.0
  contact:
    name: AI Stats
    url: https://docs.ai-stats.phaseo.app
    email: danielbutler500@gmail.com
servers:
  - url: https://api.phaseo.app/v1
security:
  - BearerAuth: []
tags:
  - name: Gateway
    description: Core AI Stats Gateway operations.
paths:
  /endpoints:
    get:
      tags:
        - Gateway
      summary: List endpoints
      description: Lists currently exposed gateway endpoint IDs and sample models.
      operationId: listEndpoints
      responses:
        '200':
          description: Endpoint metadata
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                  endpoints:
                    type: array
                    items:
                      type: string
                  sample_models:
                    type: array
                    items:
                      $ref: '#/components/schemas/ModelId'
components:
  schemas:
    ModelId:
      type: string
      description: >-
        Model identifier. This is a runtime string so newly released models can
        be used without waiting for an SDK update.
      example: ai21/jamba-large-1.7
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: Bearer token authentication

````