> ## Documentation Index
> Fetch the complete documentation index at: https://developer.sandbox.co.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Versioning

> Learn how Sandbox uses semantic versioning and how to specify API versions in your requests.

Sandbox APIs follow semantic versioning to manage changes and ensure compatibility. This guide explains how versioning works and how to specify versions in your API requests.

## Semantic versioning

Sandbox uses semantic versioning with the format `MAJOR.MINOR.PATCH`:

| **Type** | **Compatibility**                 | **Example**   |
| :------- | :-------------------------------- | :------------ |
| Major    | Backward-incompatible changes     | 1.0.0 → 2.0.0 |
| Minor    | New features, backward compatible | 2.0.0 → 2.1.0 |
| Patch    | Bug fixes, backward compatible    | 2.1.0 → 2.1.1 |

## Specifying API version

Use the `x-api-version` header to specify which version of the API you want to use:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST 'https://api.sandbox.co.in/endpoint' \
       -H 'x-api-key: YOUR_API_KEY' \
       -H 'authorization: YOUR_ACCESS_TOKEN' \
       -H 'x-api-version: 1.0'
  ```
</CodeGroup>

<Note>
  API requests without the `x-api-version` header use the latest stable version.
</Note>

## Version lifecycle

### Deprecation

When we release a new version, we may deprecate older versions. If you use a deprecated version:

* You no longer receive active maintenance for it
* It continues to work but receives no updates
* You should migrate to a supported version

We communicate deprecation notices through:

* [Changelog](/guides/developer-resources/changelog)
* E-Mail notifications
* API reference documentation

### Discontinuation

Deprecated APIs are eventually discontinued after a planned transition period. After discontinuation:

* API requests return `503 Service Unavailable`
* You must migrate to the newer version

We announce discontinuation dates through:

* Changelog updates
* E-Mail notifications to affected accounts
* Warnings in API reference pages

<Warning>
  Sandbox APIs always use the latest version, and previous versions are inaccessible. The `x-api-version` header only affects response format for specific endpoints that support version-specific responses.
</Warning>