For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • holidays.rest API
    • Introduction
    • GETcountries
    • GETcountry
    • GETlanguages
    • GETholidays
LogoLogo

languages

||View as Markdown|
GET
https://api.holidays.rest/v1/languages
GET
/v1/languages
$curl https://api.holidays.rest/v1/languages \
>     -H "Authorization: Bearer <token>"
200languages_example
1[
2  {
3    "alpha2": "ar",
4    "name": "Arabic",
5    "supported": true
6  },
7  {
8    "alpha2": "bn",
9    "name": "Bengali",
10    "supported": true
11  },
12  {
13    "alpha2": "zh",
14    "name": "Chinese",
15    "supported": true
16  },
17  {
18    "alpha2": "en",
19    "name": "English",
20    "supported": true
21  },
22  {
23    "alpha2": "fr",
24    "name": "French",
25    "supported": true
26  },
27  {
28    "alpha2": "de",
29    "name": "German",
30    "supported": true
31  },
32  {
33    "alpha2": "he",
34    "name": "Hebrew",
35    "supported": true
36  },
37  {
38    "alpha2": "hi",
39    "name": "Hindi",
40    "supported": true
41  },
42  {
43    "alpha2": "ja",
44    "name": "Japanese",
45    "supported": true
46  },
47  {
48    "alpha2": "ko",
49    "name": "Korean",
50    "supported": true
51  },
52  {
53    "alpha2": "pt",
54    "name": "Portuguese",
55    "supported": true
56  },
57  {
58    "alpha2": "ru",
59    "name": "Russian",
60    "supported": true
61  },
62  {
63    "alpha2": "es",
64    "name": "Spanish",
65    "supported": true
66  },
67  {
68    "alpha2": "tr",
69    "name": "Turkish",
70    "supported": true
71  }
72]

This endpoint retrieves all languages that are supported by holidays.rest when retrieving public holidays. By default, the API returns holiday names in all languages that are listed by this endpoint. However, if you want to filter specific languages, you can use the lang query parameter and alpha2 code of the language.

Was this page helpful?
Previous

country

Next

holidays

Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Response headers

:statusstring
nelstring
etagstring
access-control-allow-originstring
agestring
report-tostring
expiresstring
cache-controlstring
cf-cache-statusstring
cf-raystring
alt-svcstring

Response

OK
alpha2string
namestring
supportedboolean