Introduction
Provides name days for various countries
This documentation aims to provide all the information you need to work with our API.
API will NOT provide name days for requests originating from Russian or Belarus IPs - Слава Україні! Героям слава!
Base URL
https://nameday.abalin.net
Authenticating requests
This API is not authenticated.
Endpoints
Get nameday for today Endpoint lets you get nameday for today. Beware that the default timezone is 'Europe/Prague'
Example request:
$client = new \GuzzleHttp\Client();
$response = $client->post(
'https://nameday.abalin.net/api/V1/today',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'query' => [
'country'=> 'es',
'timezone'=> 'Arctic/Longyearbyen',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
curl --request POST \
"https://nameday.abalin.net/api/V1/today?country=es&timezone=Arctic%2FLongyearbyen" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
const url = new URL(
"https://nameday.abalin.net/api/V1/today"
);
const params = {
"country": "es",
"timezone": "Arctic/Longyearbyen",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "POST",
headers,
}).then(response => response.json());
Example response (200, Get all name days for today):
{
"day": 24,
"month": 2,
"nameday": {
"at": "Matthias",
"bg": "n/a",
"cz": "Matěj",
"de": "Matthias",
"dk": "Mattias",
"ee": "Madi, Madis, Mäido, Maido, Maidu, Mait, Mati, Matis, Mats, Matti, Mattias",
"es": "Modesto",
"fi": "Matias, Matti",
"fr": "Modeste",
"gr": "n/a",
"hr": "Montan, Goran, Modest, Ranko",
"hu": "Mátyás",
"it": "Modesto, Vescovo",
"lt": "Gedmantas, Goda, Motiejus",
"lv": "Diāna, Dina, Dins",
"pl": "Bogurad, Bogusz, Boguta, Maciej, Piotr",
"ru": "n/a",
"se": "Mattias",
"sk": "Matej",
"us": "Maddison, Madison, Madisyn, Madyson, Mateo, Mathew, Mathias, Matt, Mattea, Matthew, Matthias, Mattias, Mattie, Matty, Modesto"
}
}
Example response (200, Get all name days for today for specific country):
{
"day": 24,
"month": 2,
"nameday": {
"sk": "Matej"
},
"country": "sk"
}
Example response (422, Get all name days for today - wrong country):
{
"error": {
"country": [
"The selected country is invalid."
]
}
}
Example response (422, Get all name days for today - wrong timezone):
{
"error": {
"timezone": [
"The selected timezone is invalid."
]
}
}
Received response:
Request failed with error:
Get nameday for today Endpoint lets you get nameday for today. Beware that the default timezone is 'Europe/Prague'
Example request:
$client = new \GuzzleHttp\Client();
$response = $client->get(
'https://nameday.abalin.net/api/V1/today',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'query' => [
'country'=> 'es',
'timezone'=> 'Arctic/Longyearbyen',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
curl --request GET \
--get "https://nameday.abalin.net/api/V1/today?country=es&timezone=Arctic%2FLongyearbyen" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
const url = new URL(
"https://nameday.abalin.net/api/V1/today"
);
const params = {
"country": "es",
"timezone": "Arctic/Longyearbyen",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());
Example response (200, Get all name days for today):
{
"day": 24,
"month": 2,
"nameday": {
"at": "Matthias",
"bg": "n/a",
"cz": "Matěj",
"de": "Matthias",
"dk": "Mattias",
"ee": "Madi, Madis, Mäido, Maido, Maidu, Mait, Mati, Matis, Mats, Matti, Mattias",
"es": "Modesto",
"fi": "Matias, Matti",
"fr": "Modeste",
"gr": "n/a",
"hr": "Montan, Goran, Modest, Ranko",
"hu": "Mátyás",
"it": "Modesto, Vescovo",
"lt": "Gedmantas, Goda, Motiejus",
"lv": "Diāna, Dina, Dins",
"pl": "Bogurad, Bogusz, Boguta, Maciej, Piotr",
"ru": "n/a",
"se": "Mattias",
"sk": "Matej",
"us": "Maddison, Madison, Madisyn, Madyson, Mateo, Mathew, Mathias, Matt, Mattea, Matthew, Matthias, Mattias, Mattie, Matty, Modesto"
}
}
Example response (200, Get all name days for today for specific country):
{
"day": 24,
"month": 2,
"nameday": {
"sk": "Matej"
},
"country": "sk"
}
Example response (422, Get all name days for today - wrong country):
{
"error": {
"country": [
"The selected country is invalid."
]
}
}
Example response (422, Get all name days for today - wrong timezone):
{
"error": {
"timezone": [
"The selected timezone is invalid."
]
}
}
Received response:
Request failed with error:
Get nameday for tomorrow Endpoint lets you get nameday for tomorrow. Beware that the default timezone is 'Europe/Prague'
Example request:
$client = new \GuzzleHttp\Client();
$response = $client->post(
'https://nameday.abalin.net/api/V1/tomorrow',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'query' => [
'country'=> 'sk',
'timezone'=> 'Australia/North',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
curl --request POST \
"https://nameday.abalin.net/api/V1/tomorrow?country=sk&timezone=Australia%2FNorth" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
const url = new URL(
"https://nameday.abalin.net/api/V1/tomorrow"
);
const params = {
"country": "sk",
"timezone": "Australia/North",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "POST",
headers,
}).then(response => response.json());
Example response (200, Get all name days for tomorrow):
{
"day": 24,
"month": 2,
"nameday": {
"at": "Matthias",
"bg": "n/a",
"cz": "Matěj",
"de": "Matthias",
"dk": "Mattias",
"ee": "Madi, Madis, Mäido, Maido, Maidu, Mait, Mati, Matis, Mats, Matti, Mattias",
"es": "Modesto",
"fi": "Matias, Matti",
"fr": "Modeste",
"gr": "n/a",
"hr": "Montan, Goran, Modest, Ranko",
"hu": "Mátyás",
"it": "Modesto, Vescovo",
"lt": "Gedmantas, Goda, Motiejus",
"lv": "Diāna, Dina, Dins",
"pl": "Bogurad, Bogusz, Boguta, Maciej, Piotr",
"ru": "n/a",
"se": "Mattias",
"sk": "Matej",
"us": "Maddison, Madison, Madisyn, Madyson, Mateo, Mathew, Mathias, Matt, Mattea, Matthew, Matthias, Mattias, Mattie, Matty, Modesto"
}
}
Example response (200, Get all name days for tomorrow for specific country):
{
"day": 24,
"month": 2,
"nameday": {
"sk": "Matej"
},
"country": "sk"
}
Example response (422, Get all name days for tomorrow - wrong country):
{
"error": {
"country": [
"The selected country is invalid."
]
}
}
Example response (422, Get all name days for tomorrow - wrong timezone):
{
"error": {
"timezone": [
"The selected timezone is invalid."
]
}
}
Received response:
Request failed with error:
Get nameday for tomorrow Endpoint lets you get nameday for tomorrow. Beware that the default timezone is 'Europe/Prague'
Example request:
$client = new \GuzzleHttp\Client();
$response = $client->get(
'https://nameday.abalin.net/api/V1/tomorrow',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'query' => [
'country'=> 'sk',
'timezone'=> 'Australia/North',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
curl --request GET \
--get "https://nameday.abalin.net/api/V1/tomorrow?country=sk&timezone=Australia%2FNorth" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
const url = new URL(
"https://nameday.abalin.net/api/V1/tomorrow"
);
const params = {
"country": "sk",
"timezone": "Australia/North",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());
Example response (200, Get all name days for tomorrow):
{
"day": 24,
"month": 2,
"nameday": {
"at": "Matthias",
"bg": "n/a",
"cz": "Matěj",
"de": "Matthias",
"dk": "Mattias",
"ee": "Madi, Madis, Mäido, Maido, Maidu, Mait, Mati, Matis, Mats, Matti, Mattias",
"es": "Modesto",
"fi": "Matias, Matti",
"fr": "Modeste",
"gr": "n/a",
"hr": "Montan, Goran, Modest, Ranko",
"hu": "Mátyás",
"it": "Modesto, Vescovo",
"lt": "Gedmantas, Goda, Motiejus",
"lv": "Diāna, Dina, Dins",
"pl": "Bogurad, Bogusz, Boguta, Maciej, Piotr",
"ru": "n/a",
"se": "Mattias",
"sk": "Matej",
"us": "Maddison, Madison, Madisyn, Madyson, Mateo, Mathew, Mathias, Matt, Mattea, Matthew, Matthias, Mattias, Mattie, Matty, Modesto"
}
}
Example response (200, Get all name days for tomorrow for specific country):
{
"day": 24,
"month": 2,
"nameday": {
"sk": "Matej"
},
"country": "sk"
}
Example response (422, Get all name days for tomorrow - wrong country):
{
"error": {
"country": [
"The selected country is invalid."
]
}
}
Example response (422, Get all name days for tomorrow - wrong timezone):
{
"error": {
"timezone": [
"The selected timezone is invalid."
]
}
}
Received response:
Request failed with error:
Get nameday for yesterday Endpoint lets you get nameday for yesterday. Beware that the default timezone is 'Europe/Prague'
Example request:
$client = new \GuzzleHttp\Client();
$response = $client->post(
'https://nameday.abalin.net/api/V1/yesterday',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'query' => [
'country'=> 'us',
'timezone'=> 'Chile/EasterIsland',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
curl --request POST \
"https://nameday.abalin.net/api/V1/yesterday?country=us&timezone=Chile%2FEasterIsland" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
const url = new URL(
"https://nameday.abalin.net/api/V1/yesterday"
);
const params = {
"country": "us",
"timezone": "Chile/EasterIsland",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "POST",
headers,
}).then(response => response.json());
Example response (200, Get all name days for yesterday):
{
"day": 24,
"month": 2,
"nameday": {
"at": "Matthias",
"bg": "n/a",
"cz": "Matěj",
"de": "Matthias",
"dk": "Mattias",
"ee": "Madi, Madis, Mäido, Maido, Maidu, Mait, Mati, Matis, Mats, Matti, Mattias",
"es": "Modesto",
"fi": "Matias, Matti",
"fr": "Modeste",
"gr": "n/a",
"hr": "Montan, Goran, Modest, Ranko",
"hu": "Mátyás",
"it": "Modesto, Vescovo",
"lt": "Gedmantas, Goda, Motiejus",
"lv": "Diāna, Dina, Dins",
"pl": "Bogurad, Bogusz, Boguta, Maciej, Piotr",
"ru": "n/a",
"se": "Mattias",
"sk": "Matej",
"us": "Maddison, Madison, Madisyn, Madyson, Mateo, Mathew, Mathias, Matt, Mattea, Matthew, Matthias, Mattias, Mattie, Matty, Modesto"
}
}
Example response (200, Get all name days for yesterday for specific country):
{
"day": 24,
"month": 2,
"nameday": {
"sk": "Matej"
},
"country": "sk"
}
Example response (422, Get all name days for yesterday - wrong country):
{
"error": {
"country": [
"The selected country is invalid."
]
}
}
Example response (422, Get all name days for yesterday - wrong timezone):
{
"error": {
"timezone": [
"The selected timezone is invalid."
]
}
}
Received response:
Request failed with error:
Get nameday for yesterday Endpoint lets you get nameday for yesterday. Beware that the default timezone is 'Europe/Prague'
Example request:
$client = new \GuzzleHttp\Client();
$response = $client->get(
'https://nameday.abalin.net/api/V1/yesterday',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'query' => [
'country'=> 'us',
'timezone'=> 'Chile/EasterIsland',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
curl --request GET \
--get "https://nameday.abalin.net/api/V1/yesterday?country=us&timezone=Chile%2FEasterIsland" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
const url = new URL(
"https://nameday.abalin.net/api/V1/yesterday"
);
const params = {
"country": "us",
"timezone": "Chile/EasterIsland",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());
Example response (200, Get all name days for yesterday):
{
"day": 24,
"month": 2,
"nameday": {
"at": "Matthias",
"bg": "n/a",
"cz": "Matěj",
"de": "Matthias",
"dk": "Mattias",
"ee": "Madi, Madis, Mäido, Maido, Maidu, Mait, Mati, Matis, Mats, Matti, Mattias",
"es": "Modesto",
"fi": "Matias, Matti",
"fr": "Modeste",
"gr": "n/a",
"hr": "Montan, Goran, Modest, Ranko",
"hu": "Mátyás",
"it": "Modesto, Vescovo",
"lt": "Gedmantas, Goda, Motiejus",
"lv": "Diāna, Dina, Dins",
"pl": "Bogurad, Bogusz, Boguta, Maciej, Piotr",
"ru": "n/a",
"se": "Mattias",
"sk": "Matej",
"us": "Maddison, Madison, Madisyn, Madyson, Mateo, Mathew, Mathias, Matt, Mattea, Matthew, Matthias, Mattias, Mattie, Matty, Modesto"
}
}
Example response (200, Get all name days for yesterday for specific country):
{
"day": 24,
"month": 2,
"nameday": {
"sk": "Matej"
},
"country": "sk"
}
Example response (422, Get all name days for yesterday - wrong country):
{
"error": {
"country": [
"The selected country is invalid."
]
}
}
Example response (422, Get all name days for yesterday - wrong timezone):
{
"error": {
"timezone": [
"The selected timezone is invalid."
]
}
}
Received response:
Request failed with error:
Get nameday for specific date This endpoint lets you get nameday for this day. Beware that the default timezone is 'Europe/Prague'
Example request:
$client = new \GuzzleHttp\Client();
$response = $client->get(
'https://nameday.abalin.net/api/V1/getdate',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'query' => [
'day'=> '18',
'month'=> '11',
'country'=> 'hu',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
curl --request GET \
--get "https://nameday.abalin.net/api/V1/getdate?day=18&month=11&country=hu" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
const url = new URL(
"https://nameday.abalin.net/api/V1/getdate"
);
const params = {
"day": "18",
"month": "11",
"country": "hu",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());
Example response (200, Get name days for specific date):
{
"day": 18,
"month": 11,
"nameday": {
"fi": "Tenho",
"bg": "n/a",
"us": "Odelia, Odell, Odo, Sutherland, Sutton",
"hr": "Posveta Bazilike sv. Petra i Pavla",
"es": "Aurelio",
"dk": "Hesychius",
"it": "Dedicazione Delle Basiliche Dei Santi Pietro E Paolo",
"lt": "Ginvydas, Ginvyde, Otonas, Romanas, Salomeja",
"gr": "Platonas",
"fr": "Aude",
"hu": "Jenő",
"at": "Odo, Philippine",
"lv": "Aleksandrs, Doloresa",
"de": "Alda, Bettina, Odo, Roman",
"ru": "n/a",
"pl": "Aniela, Cieszymysł, Klaudyna, Roman, Tomasz",
"sk": "Eugen",
"se": "Magnhild",
"cz": "Romana",
"ee": "Ilo, Ilu"
}
}
Example response (200, Get name days for specific date for specific country):
{
"day": 18,
"month": 11,
"nameday": {
"ee": "Ilo, Ilu"
},
"country": "ee"
}
Example response (422, Get name days for specific date - wrong country):
{
"error": {
"country": [
"The selected country is invalid."
]
}
}
Example response (422, Get name days for specific date - wrong date):
{
"error": {
"month": [
"The month must not be greater than 12.",
"Date is invalid"
]
}
}
Received response:
Request failed with error:
Get nameday for specific date This endpoint lets you get nameday for this day. Beware that the default timezone is 'Europe/Prague'
Example request:
$client = new \GuzzleHttp\Client();
$response = $client->post(
'https://nameday.abalin.net/api/V1/getdate',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'query' => [
'day'=> '18',
'month'=> '11',
'country'=> 'hu',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
curl --request POST \
"https://nameday.abalin.net/api/V1/getdate?day=18&month=11&country=hu" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
const url = new URL(
"https://nameday.abalin.net/api/V1/getdate"
);
const params = {
"day": "18",
"month": "11",
"country": "hu",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "POST",
headers,
}).then(response => response.json());
Example response (200, Get name days for specific date):
{
"day": 18,
"month": 11,
"nameday": {
"fi": "Tenho",
"bg": "n/a",
"us": "Odelia, Odell, Odo, Sutherland, Sutton",
"hr": "Posveta Bazilike sv. Petra i Pavla",
"es": "Aurelio",
"dk": "Hesychius",
"it": "Dedicazione Delle Basiliche Dei Santi Pietro E Paolo",
"lt": "Ginvydas, Ginvyde, Otonas, Romanas, Salomeja",
"gr": "Platonas",
"fr": "Aude",
"hu": "Jenő",
"at": "Odo, Philippine",
"lv": "Aleksandrs, Doloresa",
"de": "Alda, Bettina, Odo, Roman",
"ru": "n/a",
"pl": "Aniela, Cieszymysł, Klaudyna, Roman, Tomasz",
"sk": "Eugen",
"se": "Magnhild",
"cz": "Romana",
"ee": "Ilo, Ilu"
}
}
Example response (200, Get name days for specific date for specific country):
{
"day": 18,
"month": 11,
"nameday": {
"ee": "Ilo, Ilu"
},
"country": "ee"
}
Example response (422, Get name days for specific date - wrong country):
{
"error": {
"country": [
"The selected country is invalid."
]
}
}
Example response (422, Get name days for specific date - wrong date):
{
"error": {
"month": [
"The month must not be greater than 12.",
"Date is invalid"
]
}
}
Received response:
Request failed with error:
search name day by name This endpoint lets you search specific name and returns his/her name day date
Example request:
$client = new \GuzzleHttp\Client();
$response = $client->get(
'https://nameday.abalin.net/api/V1/getname',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'query' => [
'name'=> 'Walenty',
'country'=> 'pl',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
curl --request GET \
--get "https://nameday.abalin.net/api/V1/getname?name=Walenty&country=pl" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
const url = new URL(
"https://nameday.abalin.net/api/V1/getname"
);
const params = {
"name": "Walenty",
"country": "pl",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());
Example response (200, Get name day for specific name):
{
"0": [
{
"day": 7,
"month": 7,
"name": "Oliver"
}
],
"country": "sk"
}
Example response (422, Get name day for specific name - wrong country code):
{
"error": {
"country": [
"The selected country is invalid."
]
}
}
Example response (422, Get name day for specific name - wrong name):
{
"error": {
"name": [
"The name must be at least 2 characters."
]
}
}
Received response:
Request failed with error:
search name day by name This endpoint lets you search specific name and returns his/her name day date
Example request:
$client = new \GuzzleHttp\Client();
$response = $client->post(
'https://nameday.abalin.net/api/V1/getname',
[
'headers' => [
'Content-Type' => 'application/json',
'Accept' => 'application/json',
],
'query' => [
'name'=> 'Walenty',
'country'=> 'pl',
],
]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
curl --request POST \
"https://nameday.abalin.net/api/V1/getname?name=Walenty&country=pl" \
--header "Content-Type: application/json" \
--header "Accept: application/json"
const url = new URL(
"https://nameday.abalin.net/api/V1/getname"
);
const params = {
"name": "Walenty",
"country": "pl",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "POST",
headers,
}).then(response => response.json());
Example response (200, Get name day for specific name):
{
"0": [
{
"day": 7,
"month": 7,
"name": "Oliver"
}
],
"country": "sk"
}
Example response (422, Get name day for specific name - wrong country code):
{
"error": {
"country": [
"The selected country is invalid."
]
}
}
Example response (422, Get name day for specific name - wrong name):
{
"error": {
"name": [
"The name must be at least 2 characters."
]
}
}
Received response:
Request failed with error: