Países

Referência de países ISO-3166-1 alpha-2. Atualmente no standalone endpoint — países são dados de referência semeados e aparecem apenas através de outros endpoints.

Sem endpoint próprio (ainda)

Hoje não existe rota pública GET /api/v1/countries. Os dados de países vivem na tabela `countries` e são expostos indiretamente via GET /sandbox/defaults?brand=N (um país por marca como padrão inteligente) e GET /tenancy/brands/{brandId}/countries (matriz por marca × por tenant). O roadmap prevê uma listagem plana `/countries` — esta página irá documentá-la quando entregue.

Onde os dados de países aparecem hoje

/sandbox/defaults retorna o código de país padrão para qualquer id de marca. /fleet/list aceita `passenger_country_code` (ISO-2). /places/search aceita `country_id` para limitar resultados.

bash

# Smart-default country for AVIS (resolves to US):
curl -s "https://greenflow.live/api/v1/sandbox/defaults?brand=1" \
  -H "Authorization: Bearer gfc_7s2wprmy_DWTZRBGBEV6La4dTOoFdMkEhWmWCsXdwc3zVMnqP"

json

{
  "vendor": "AVIS",
  "country": "US",
  "city": "Miami",
  "lat": 25.77125531,
  "lng": -80.19186806,
  "place_uuid": "9566c9fe-a2d6-451b-a754-e2fee27a2c8f",
  "place_name": "Miami Downtown"
}

Erros

HTTP	Body	Causa
404	{"message": "Not Found"}	Hitting `/api/v1/countries` directly returns 404 — not yet wired.