Puesto Labs
IntroductionAuthenticationPagination & sortingSyncing with the changes feedErrorsRate limitsBuilding with AI

Here you can add a description about your company or product

© Copyright 2026 Puesto Labs. All Rights Reserved.

About
  • Blog
  • Contact
Product
  • Documentation
  • llms.txt
Legal
  • Terms of Service
  • Privacy Policy
  • Cookie Policy
Puesto Docs

List countries

GET
/api/v1/locations/countries

List every country available as a country filter value. Each code is the exact two-letter value the jobs country filter accepts. Rows share the kind / code / population vocabulary of GET /locations/search, so one client type covers all three location endpoints. For type-ahead over countries, states, cities and regions at once, use GET /locations/search instead — this endpoint is for building a complete facet list.

Authorization

bearerAuth
AuthorizationBearer <token>

Provide your secret API key (prefixed sk_) as a bearer token: Authorization: Bearer sk_....

In: header

Response Body

application/json

application/problem+json

application/problem+json

curl -X GET "https://example.com/api/v1/locations/countries"
{  "data": [    {      "kind": "country",      "code": "string",      "name": "string",      "slug": "string",      "population": 0    }  ]}
{  "type": "string",  "title": "string",  "status": 0,  "detail": "string",  "errors": [    {      "field": "string",      "message": "string"    }  ]}
{  "type": "string",  "title": "string",  "status": 0,  "detail": "string",  "errors": [    {      "field": "string",      "message": "string"    }  ]}