Countries

ISO-3166-1 alpha-2 country reference. Currently no standalone endpoint — countries are seeded reference data and surface only through other endpoints.

No standalone endpoint (yet)

There is no public GET /api/v1/countries route today. Country data lives in the `countries` table and is exposed indirectly via GET /sandbox/defaults?brand=N (one country per brand smart-default) and GET /tenancy/brands/{brandId}/countries (per-brand × per-tenant matrix). The roadmap calls for a flat `/countries` listing — this page will document it once shipped.

Where country data shows up today

/sandbox/defaults returns the smart-default country code for any brand id. /fleet/list accepts `passenger_country_code` (ISO-2). /places/search accepts `country_id` to scope results.

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

Errors

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