List Models

ModelListPageResponse Beta.Models.List(, )

GET/v1/models

List available models.

The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.

ParametersExpand Collapse

ModelListParams parameters

string afterID

Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.

string beforeID

Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.

Long limit

Query param: Number of items to return per page.

Defaults to 20. Ranges from 1 to 1000.

maximum1000

minimum1

IReadOnlyList<AnthropicBeta> betas

Header param: Optional header to specify the beta version(s) you want to use.

ReturnsExpand Collapse

class ModelListPageResponse:

required IReadOnlyList<BetaModelInfo> Data

required string ID

Unique model identifier.

required DateTimeOffset CreatedAt

RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.

required string DisplayName

A human-readable name for the model.

JsonElement Type

Object type.

For Models, this is always "model".

required string? FirstID

First ID in the data list. Can be used as the before_id for the previous page.

required Boolean HasMore

Indicates if there are more results in the requested page direction.

required string? LastID

Last ID in the data list. Can be used as the after_id for the next page.

List Models

ModelListParams parameters = new();

var page = await client.Beta.Models.List(parameters);
await foreach (var item in page.Paginate())
{
    Console.WriteLine(item);
}

Response 200

{
  "data": [
    {
      "id": "claude-opus-4-6",
      "created_at": "2026-02-04T00:00:00Z",
      "display_name": "Claude Opus 4.6",
      "type": "model"
    }
  ],
  "first_id": "first_id",
  "has_more": true,
  "last_id": "last_id"
}

Returns Examples

Response 200

{
  "data": [
    {
      "id": "claude-opus-4-6",
      "created_at": "2026-02-04T00:00:00Z",
      "display_name": "Claude Opus 4.6",
      "type": "model"
    }
  ],
  "first_id": "first_id",
  "has_more": true,
  "last_id": "last_id"
}

{ "data": [ { "id": "claude-opus-4-6", "created_at": "2026-02-04T00:00:00Z", "display_name": "Claude Opus 4.6", "type": "model" } ], "first_id": "first_id", "has_more": true, "last_id": "last_id" }