countries

3 endpoints at a glance

Method	Path	Summary
GET	/locations/countries	List Countries
GET	/locations/countries/{cca2}	Get Country
POST	/locations/countries/refresh	Refresh Countries

countries

---

List Countries

GET

/locations/countries

All countries.

details=false (default) → slim {code, name, region, flag}
picker payload. details=true → the full {code, data, meta}
envelope per row. Both ordered alphabetically by common name.

Parameters

Header Parameters

authorization

Query Parameters

details

Type

boolean

Default

false

Responses

Successful Response

Content-Type

application/json

[

  

{

  

  

"additionalProperties": "string"

  

}

]

GET

/locations/countries

Playground

Headers

authorization

Variables

Key

Value

details

Samples

---

Get Country

GET

/locations/countries/{cca2}

Parameters

Header Parameters

authorization

Path Parameters

cca2*

Type

string

Required

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/locations/countries/{cca2}

Playground

Headers

authorization

Variables

Key

Value

cca2*

Samples

---

Refresh Countries

POST

/locations/countries/refresh

Pull the latest country dataset from REST Countries (admin only).

Runs the (blocking) HTTP + bulk-upsert off the event loop and records
a task_history row so the admin panel sees it.

Parameters

Header Parameters

authorization

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

POST

/locations/countries/refresh

Playground

Headers

authorization

Samples

---