---
title: "Get supported API versions"
url: https://docs.truemarkets.co/api/institutional/get-api-versions-cefi
description: "Returns a list of supported API versions with their deprecation status. Use this endpoint to discover available versions and plan migrations when versions are deprecated."
---

Docs index: https://docs.truemarkets.co/llms.txt

# Get supported API versions

Returns a list of supported API versions with their deprecation status. Use this endpoint to discover available versions and plan migrations when versions are deprecated.

## Request

```
GET https://api.truex.co/v1/cefi/versions
```

## Responses

Every error status returns the same body, described in [Errors](https://docs.truemarkets.co/developer-resources/errors.md).

### 200

List of supported API versions.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `supported_versions` | array of object | yes | List of all supported API versions. |
| `supported_versions[].version` | string | yes | The version identifier to use in the X-Truex-Version header. |
| `supported_versions[].deprecated` | boolean | yes | Whether this version is deprecated and scheduled for removal. |
| `supported_versions[].deprecation_date` | string | no | HTTP-date format timestamp of when the version was deprecated. Only present if deprecated is true. |
| `supported_versions[].sunset_date` | string | no | HTTP-date format timestamp of when the version will be removed. Only present if deprecated is true. |
| `default_version` | string | yes | The version used when no X-Truex-Version header is provided. |
| `version_header` | string | yes | The header name to use for specifying API version. |

### 400

Bad request.
