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

# GET Agencies

> Liste les agences accessibles par votre clé (et le groupe d'agences).

Liste les **agences** du périmètre de votre token, ainsi que le **groupe d'agences**.

> [!NOTE]
>
> Utile pour récupérer les `agencyId` valides à passer à `POST
>     /external-integration/contact`, les valeurs de `settings.allocation` à la
> création d'un lead, et pour mapper les agences de vos fiches.

> [!NOTE]
>
> La liste suit le périmètre de votre clé. Une agence ouverte dans votre groupe
> après la création de votre clé y figure, sans démarche de votre part. Une agence
> désactivée n'y figure pas.

## Endpoint

**URL** : `/external-integration/agencies`
**Méthode** : `GET`
**Authentification** : Requiert un token LinkedAPI avec scope `externalIntegration` et une clé rattachée à un groupe d'agences.
**Clé requise** : toutes les clés (lecture seule suffit). Voir [Types de clé](https://developers.avest.fr/guides/authentification.md).

## Headers

```
Authorization: Bearer {token}
```

## Réponse de succès

**Code** : `200`

```json theme={null}
{
  "success": true,
  "agencyGroup": {
    "id": "66cc8a8e75c9fac35c6ecd73",
    "name": "Groupe Avest"
  },
  "agencies": [
    { "id": "66cc91d475c9fac35c86ed80", "name": "Avest Paris 14e" },
    { "id": "66cc92295f84c9b212dab7ef", "name": "Avest Lyon" }
  ]
}
```

## Champs de la réponse

| Champ | Type | Description |
| - | - | - |
| `agencyGroup.id` | String | ObjectId du groupe d'agences de la clé. |
| `agencyGroup.name` | String | Nom du groupe d'agences. |
| `agencies[].id` | String | ObjectId de l'agence (à utiliser comme `agencyId`). |
| `agencies[].name` | String | Nom de l'agence. |

## Réponses d'erreur

* **Header `Authorization` absent, ou IP non whitelistée sur une clé sécurisée** : `403 Not authorized to access this resource`

```json theme={null}
{
  "success": false,
  "message": "Not authorized to access this resource"
}
```

* **Token invalide** : `401 Invalid bearer token`

```json theme={null}
{
  "success": false,
  "message": "Invalid bearer token"
}
```

## Rate limits

Limitée par groupe d'agences (bucket de lecture). Dépassement → `429 Too Many Requests`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.