# List models

List the Genesis models that the current credentials can call, and obtain a model ID for later requests.

```text
GET https://token.moi.matrixorigin.cn/v1/models
```

## Before you call

Prepare credentials with Genesis access. Replace `$GENESIS_ACCESS_TOKEN` with your access credential.

```bash
curl "https://token.moi.matrixorigin.cn/v1/models" \
  -H "Authorization: Bearer $GENESIS_ACCESS_TOKEN"
```

## Request parameters

This is a `GET` request. It accepts neither query parameters nor a request body; pass the access credential only in the `Authorization` request header.

## Successful response

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} Response example

```json
{
  "data": [
    { "id": "$MODEL_ID" }
  ]
}
```

:::::
:::::{tab-item} Field description

::::{tab-set}
:::{tab-item} Common fields

| Field | Type | Description |
| --- | --- | --- |
| `data` | array of object | Models that the current credentials can call. |

:::
:::{tab-item} Result item

The following table expands each item in the example `data` array.

| Field | Type | Description |
| --- | --- | --- |
| `id` | string | Model ID. |

:::
::::

:::::
::::::
:::::::

## Next steps

Copy the required model ID and pass it as `model` to [Chat Completions](text-generation/chat-completions.md), [Responses](text-generation/responses.md), [Embeddings](text-embeddings/embeddings.md), or [Rerank](text-reranking/rerank.md).