---
title: "Get AI residency options"
url: https://docs.gleap.ai/en/reference/rest-api/get-residency-options
method: GET
path: "/ai-models/residency-options"
api: "API Reference"
tag: "AI models"
operationId: "GetResidencyOptions"
updatedAt: "2026-11-11T10:00:00.893Z"
language: en
---

# Get AI residency options

`GET https://api.gleap.io/v3/ai-models/residency-options`

The AI residency choices of the deployment this API runs in (EU or US only, or global), the recommended one, and whether signup and the privacy settings offer the choice yet.

## Authorization

- `Authorization` (header, required): `Bearer <token>`

## Example request

```bash
curl --request GET \
  --url https://api.gleap.io/v3/ai-models/residency-options \
  --header 'Authorization: Bearer <token>'
```

## Responses

### 200 (`application/json`)

Ok

- `region` (enum<string>, required): The deployment this API runs in. One of: `eu`, `us`.
- `options` (enum<string>[], required): The choices this deployment offers, regional option first.
- `recommended` (enum<string>, required): Where an organisation's AI agents run. Stored on the organisation as `aiResidency`. One of: `global`, `eu`, `us`.

```json
{
  "region": "eu",
  "options": [
    "global"
  ],
  "recommended": "global"
}
```