Skip to main content
GET
/
entities
/
{id}
/
country-activations
Listar activaciones de país por entidad
curl --request GET \
  --url http://api.gu1.ai/entities/{id}/country-activations \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data.entityId": "<string>",
  "data.countries": [
    {}
  ]
}

​
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. 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). 
Authorization: Bearer YOUR_API_KEY

​
Path Parameters

​
id
string
required
UUID de la entidad (merchant).

​
Respuesta

​
success
boolean
Indica si la solicitud fue exitosa.
​
data.entityId
string
UUID de la entidad.
​
data.countries
array
Lista fija de seis países con metadata de activación.
Cada ítem en data.countries:
CampoTipoDescripción
countryCodestringISO 3166-1 alpha-2 (AR, BR, CL, CO, MX, US)
statusstringdeactivated, activation_requested, activation_in_progress o activated
activatedAtstring | nullTimestamp ISO de la última vez en activated
deactivatedAtstring | nullTimestamp ISO de la última vez en deactivated
updatedAtstring | nullTimestamp ISO del último cambio (null si nunca se seteó)

​
Ejemplo

curl -X GET "https://api.gu1.ai/entities/550e8400-e29b-41d4-a716-446655440000/country-activations" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "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

HTTPCodeCuándo
404ENTITY_NOT_FOUNDLa entidad no existe en la organización actual