JDay

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

FieldTypeDescription
codestringISO 3166-1 alpha-2 country code.
namestringCountry display name.
weekend_daysnumber[]Weekend day numbers. 1=Mon through 7=Sun.
timezonestringPrimary timezone hint. Metadata only — not used for computation.
region_supportbooleanWhether this country supports the region parameter.
regionsarrayAvailable regions. Empty [] for countries without region support.
notesstring[]Always present. Empty [] when no notes.

Region Object

FieldTypeDescription
codestringISO 3166-2 subdivision suffix (e.g., NY, ENG, BY).
namestringRegion display name.

Notes

  • regions and notes are always present — never omitted.
  • weekend_days reflects the weekend rule for the supported date range (2025–2027).
  • No year-specific aggregate fields are exposed on this endpoint in v1.

Error Cases

ConditionError
Invalid credentials401 unauthorized

On this page