List Models

List all AI models in your workspace with summary information including usage counts. Available on all plans.

GET /models

cURL

cURL

curl --request GET \
  --url https://www.greenflash.ai/api/v1/models \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "canonicalId": "gpt-4o",
    "displayName": "GPT-4o",
    "provider": "OpenAI",
    "family": "GPT-4",
    "usageCount": 4520,
    "lastUsedAt": "2025-10-15T14:30:00Z"
  },
  {
    "id": "223e4567-e89b-12d3-a456-426614174001",
    "canonicalId": "claude-3-5-sonnet-20241022",
    "displayName": "Claude 3.5 Sonnet",
    "provider": "Anthropic",
    "family": "Claude 3.5",
    "usageCount": 2130,
    "lastUsedAt": "2025-10-15T12:15:00Z"
  },
  {
    "id": "323e4567-e89b-12d3-a456-426614174002",
    "canonicalId": "gemini-1.5-pro",
    "displayName": "Gemini 1.5 Pro",
    "provider": "Google",
    "family": "Gemini 1.5",
    "usageCount": 890,
    "lastUsedAt": "2025-10-14T18:00:00Z"
  }
]

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page · number

Page number.

Required range: x >= 1

pageSize · number

Number of results per page (max 100).

Required range: 1 <= x <= 100

Response

200

application/json

Models retrieved successfully

id · string<uuid> · required

The model ID.

canonicalId · string · required

The canonical model identifier.

displayName · string · required

Human-readable model name.

provider · string · required

Model provider (e.g. OpenAI, Anthropic).

family · string | null · required

Model family grouping.

usageCount · number · required

Number of conversations using this model.

lastUsedAt · string<date-time> | null · required

When the model was last used.