Listar activaciones de país por entidad
curl --request GET \
--url http://api.gu1.ai/entities/{id}/country-activations \
--header 'Authorization: Bearer <token>'import requests
url = "http://api.gu1.ai/entities/{id}/country-activations"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://api.gu1.ai/entities/{id}/country-activations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "http://api.gu1.ai/entities/{id}/country-activations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "http://api.gu1.ai/entities/{id}/country-activations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://api.gu1.ai/entities/{id}/country-activations")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/entities/{id}/country-activations")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data.entityId": "<string>",
"data.countries": [
{}
]
}Referencia API
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.
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>'import requests
url = "http://api.gu1.ai/entities/{id}/country-activations"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://api.gu1.ai/entities/{id}/country-activations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "http://api.gu1.ai/entities/{id}/country-activations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "http://api.gu1.ai/entities/{id}/country-activations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://api.gu1.ai/entities/{id}/country-activations")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/entities/{id}/country-activations")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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 webhookentity.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
Requiereentities:read (fallback legacy: rol viewer / entities:read).
Authorization: Bearer YOUR_API_KEY
Path Parameters
string
required
UUID de la entidad (merchant).
Respuesta
boolean
Indica si la solicitud fue exitosa.
string
UUID de la entidad.
array
Lista fija de seis países con metadata de activación.
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
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
| HTTP | Code | Cuándo |
|---|---|---|
| 404 | ENTITY_NOT_FOUND | La entidad no existe en la organización actual |
Was this page helpful?