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

# List PIN Models

> Retrieve a paginated list of all models registered in the PIN service. Also accessible via the checkpoints alias endpoint.

The List Models endpoint returns every model visible to your account, including base checkpoints and fine-tuned variants. You can also call the alias path `/v1/checkpoints` to get the same results.

## Endpoint

```http theme={null}
GET /v1/models
```

## Authentication

Send your token in the `Authorization: Bearer <jwt-or-api-key>` header.

## Response

<ResponseField name="code" type="integer">
  Always 0 for success.
</ResponseField>

<ResponseField name="message" type="string">
  Empty on success.
</ResponseField>

<ResponseField name="data" type="object">
  <ResponseField name="items" type="array">
    Each element is a Model object.
  </ResponseField>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -s https://ariapin.example.com/v1/models \
    -H "Authorization: Bearer $ARIA_PIN_TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "code": 0,
    "message": "",
    "data": {
      "items": [
        {
          "id": "mdl_01J8Q2R4TFK9Z0X",
          "name": "Llama-3-8B-Instruct",
          "status": "ready"
        }
      ]
    }
  }
  ```
</ResponseExample>


## Related topics

- [List All Model Export Jobs - PIN API](/api-reference/pin/exports/list.md)
- [List All Training Checkpoints - PIN API](/api-reference/pin/checkpoints/list.md)
- [GET /v1/models: List router entrypoints and provider models](/api-reference/router/openai/list-models.md)
- [Router Management Plane Models List API](/api-reference/router/management/models.md)
- [PIN List Datasets](/api-reference/pin/datasets/list.md)