Listar ativações de país por entidade
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": [
{}
]
}Referência API
Listar ativações de país por entidade
Consulta flags operacionais de ativação por país para um merchant (AR, BR, CL, CO, MX, US). Países sem linha são retornados como deactivated.
GET
/
entities
/
{id}
/
country-activations
Listar ativações de país por entidade
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
Retorna o estado operacional de ativação por país para uma entidade merchant. É apenas um flag operacional — não altera dados da entidade, enrichments ou status de compliance. Integradores normalmente reconsultam a entidade completa após receber o webhookentity.country_activation_changed.
Países suportados (v1): AR, BR, CL, CO, MX, US.
Se não existir linha para um país, a API retorna deactivated (modelo opt-in).
Endpoint
GET http://api.gu1.ai/entities/{id}/country-activations
Autenticação
Requerentities:read (fallback legacy: papel viewer / entities:read).
Authorization: Bearer YOUR_API_KEY
Path Parameters
string
required
UUID da entidade (merchant).
Resposta
boolean
Indica se a solicitação foi bem-sucedida.
string
UUID da entidade.
array
Lista fixa de seis países com metadata de ativação.
data.countries:
| Campo | Tipo | Descrição |
|---|---|---|
countryCode | string | ISO 3166-1 alpha-2 (AR, BR, CL, CO, MX, US) |
status | string | deactivated, activation_requested, activation_in_progress ou activated |
activatedAt | string | null | Timestamp ISO da última vez em activated |
deactivatedAt | string | null | Timestamp ISO da última vez em deactivated |
updatedAt | string | null | Timestamp ISO da última alteração (null se nunca definido) |
Exemplo
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"
}
]
}
}
Erros
| HTTP | Code | Quando |
|---|---|---|
| 404 | ENTITY_NOT_FOUND | A entidade não existe na organização atual |
Was this page helpful?