GatewayDocsOpen workspace ↗
Developer preview · Synthetic data only Launch status ↗
Documentation/API reference

List models

GET /v1/models — discover the aliases available to your key.

Endpoint

http
GET /v1/models
Authorization: Bearer <GATEWAY_API_KEY>

This read-only request does not generate model tokens or make a completion call. A missing, invalid, paused, revoked, or wrong-environment key receives 401. Live-mode account onboarding is checked as part of authentication.

Example request & response

shell
curl "$GATEWAY_BASE_URL/v1/models" \
  -H "Authorization: Bearer $GATEWAY_API_KEY"
json
{
  "object": "list",
  "data": [
    {
      "id": "care-small",
      "object": "model",
      "owned_by": "gateway"
    }
  ]
}

This is an example for a demo key scoped to Care Small. Your list depends on its environment, key permissions, and configured availability.

Response fields

Each model includes id, object, owned_by, and capabilities with boolean streaming, structuredOutputs, and tools fields. These describe this gateway implementation, not every feature the underlying model offers. A capability does not imply PHI approval.

What discovery does not expose

The response does not include prices, context windows, provider credentials, underlying model IDs, or a PHI eligibility certificate. Consult the workspace catalog and healthcare controls for those details. There are currently no pagination parameters or public model-detail endpoint.

Search documentation

Search all 25 guides and references.