GET /v1/countries
List all supported countries with metadata, regions, and weekend rules.
Parameters
This endpoint takes no query parameters.
Request
curl -X GET "https://jday-api.jday.workers.dev/v1/countries" \
-H "Authorization: Bearer jday_live_xxx" \
-H "Accept: application/json"Response
{
"countries": [
{
"code": "US",
"name": "United States",
"weekend_days": [6, 7],
"timezone": "America/New_York",
"region_support": true,
"regions": [
{ "code": "CA", "name": "California" },
{ "code": "NY", "name": "New York" }
],
"notes": []
},
{
"code": "ZA",
"name": "South Africa",
"weekend_days": [6, 7],
"timezone": "Africa/Johannesburg",
"region_support": false,
"regions": [],
"notes": []
}
]
}The countries array is sorted by code ascending. The example above is abbreviated — the full response includes all 20 supported countries.
Response Fields
Country Object
| Field | Type | Description |
|---|---|---|
code | string | ISO 3166-1 alpha-2 country code. |
name | string | Country display name. |
weekend_days | number[] | Weekend day numbers. 1=Mon through 7=Sun. |
timezone | string | Primary timezone hint. Metadata only — not used for computation. |
region_support | boolean | Whether this country supports the region parameter. |
regions | array | Available regions. Empty [] for countries without region support. |
notes | string[] | Always present. Empty [] when no notes. |
Region Object
| Field | Type | Description |
|---|---|---|
code | string | ISO 3166-2 subdivision suffix (e.g., NY, ENG, BY). |
name | string | Region display name. |
Notes
regionsandnotesare always present — never omitted.weekend_daysreflects the weekend rule for the supported date range (2025–2027).- No year-specific aggregate fields are exposed on this endpoint in v1.
Error Cases
| Condition | Error |
|---|---|
| Invalid credentials | 401 unauthorized |