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

# List Contexts

List the available context variations for the project's active scope — every region, its currency, and the supported locales (each with the URL it's reachable at). Useful for building region/language switchers and for discovering valid `region`/`locale` values to pass to [Update Context](/reference/fetch-api/update-context).

## Path Parameters

<ParamField path="project-token" type="string" required>
  Your project's Fetch token, embedded in the subdomain.
</ParamField>

## Headers

<ParamField header="fs-context" type="string">
  Optional. When set, the response is the variations available within this token's scope.
</ParamField>

<ParamField header="fs-domain" type="string">
  Optional. When set without `fs-context`, the response is the variations for the scope tied to this domain.
</ParamField>

<ParamField header="fs-secret" type="string">
  Required when the project has fetch API keys configured.
</ParamField>

## Response

Returns an array of context variations. The active `contextKey` (created or reused) is also returned in the `fs-context` response header.

<ResponseField name="region" type="string" required>
  The region key.
</ResponseField>

<ResponseField name="currency" type="string" required>
  The region's ISO 4217 currency code.
</ResponseField>

<ResponseField name="locales" type="array" required>
  Supported locales for the region, each with:

  * `key` — locale code (e.g. `de-DE`)
  * `url` — domain mapping URL for this region+locale combination
</ResponseField>

### Status codes

| Code  | When                                                                           |
| ----- | ------------------------------------------------------------------------------ |
| `200` | Variations returned                                                            |
| `401` | `fs-secret` missing or wrong (only when the project has fetch keys configured) |
| `403` | Project's plan limit for Fetch API requests exceeded                           |

<RequestExample>
  ```bash curl theme={"theme":"css-variables"}
  curl 'https://fetch-<project-token>.frontic.com/context' \
    -H 'fs-context: <context-key>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"theme":"css-variables"}
  [
    {
      "region": "eu",
      "currency": "EUR",
      "locales": [
        { "key": "de-DE", "url": "https://<your-shop>/de" },
        { "key": "en-GB", "url": "https://<your-shop>/uk" },
        { "key": "fr-FR", "url": "https://<your-shop>/fr" }
      ]
    },
    {
      "region": "us",
      "currency": "USD",
      "locales": [
        { "key": "en-US", "url": "https://<your-shop>/us" }
      ]
    }
  ]
  ```
</ResponseExample>