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

# Listar activaciones de país por entidad

> Consulta flags operativos de activación por país para un merchant (AR, BR, CL, CO, MX, US). Países sin fila se devuelven como deactivated.

## Overview

Devuelve el estado operativo de activación por país para una entidad merchant. Es un **flag operativo únicamente** — no modifica datos de la entidad, enrichments ni estado de compliance. Los integradores suelen volver a consultar la entidad completa tras recibir el webhook [`entity.country_activation_changed`](/es/webhooks/events/entity-events).

Países soportados (v1): **AR**, **BR**, **CL**, **CO**, **MX**, **US**.

Si no existe fila para un país, la API devuelve `deactivated` (modelo opt-in).

## Endpoint

```
GET http://api.gu1.ai/entities/{id}/country-activations
```

## Autenticación

Requiere `entities:read` (fallback legacy: rol viewer / `entities:read`).

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Path Parameters

<ParamField path="id" type="string" required>
  UUID de la entidad (merchant).
</ParamField>

## Respuesta

<ResponseField name="success" type="boolean">
  Indica si la solicitud fue exitosa.
</ResponseField>

<ResponseField name="data.entityId" type="string">
  UUID de la entidad.
</ResponseField>

<ResponseField name="data.countries" type="array">
  Lista fija de seis países con metadata de activación.
</ResponseField>

Cada ítem en `data.countries`:

| Campo           | Tipo           | Descripción                                                                   |
| --------------- | -------------- | ----------------------------------------------------------------------------- |
| `countryCode`   | string         | ISO 3166-1 alpha-2 (`AR`, `BR`, `CL`, `CO`, `MX`, `US`)                       |
| `status`        | string         | `deactivated`, `activation_requested`, `activation_in_progress` o `activated` |
| `activatedAt`   | string \| null | Timestamp ISO de la última vez en `activated`                                 |
| `deactivatedAt` | string \| null | Timestamp ISO de la última vez en `deactivated`                               |
| `updatedAt`     | string \| null | Timestamp ISO del último cambio (`null` si nunca se seteó)                    |

## Ejemplo

```bash theme={null}
curl -X GET "https://api.gu1.ai/entities/550e8400-e29b-41d4-a716-446655440000/country-activations" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```json theme={null}
{
  "success": true,
  "data": {
    "entityId": "550e8400-e29b-41d4-a716-446655440000",
    "countries": [
      {
        "countryCode": "AR",
        "status": "deactivated",
        "activatedAt": null,
        "deactivatedAt": null,
        "updatedAt": null
      },
      {
        "countryCode": "CO",
        "status": "activation_in_progress",
        "activatedAt": null,
        "deactivatedAt": null,
        "updatedAt": "2026-07-03T15:00:00.000Z"
      },
      {
        "countryCode": "MX",
        "status": "activated",
        "activatedAt": "2026-07-03T15:00:00.000Z",
        "deactivatedAt": null,
        "updatedAt": "2026-07-03T15:00:00.000Z"
      }
    ]
  }
}
```

## Errores

| HTTP | Code               | Cuándo                                         |
| ---- | ------------------ | ---------------------------------------------- |
| 404  | `ENTITY_NOT_FOUND` | La entidad no existe en la organización actual |