Skip to main content
GET
/
models
cURL
curl --request GET \
  --url https://www.greenflash.ai/api/v1/models \
  --header 'Authorization: Bearer <token>'
[
  {
    "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

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.