MENU navbar-image

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."
        ]
    }
}
 

Request      

POST api/V1/today

Query Parameters

country  string optional  

One of supported country codes.

timezone  string optional  

PHP timezone. If nothing provided default TZ is 'Europe/Prague'.

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."
        ]
    }
}
 

Request      

GET api/V1/today

Query Parameters

country  string optional  

One of supported country codes.

timezone  string optional  

PHP timezone. If nothing provided default TZ is 'Europe/Prague'.

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."
        ]
    }
}
 

Request      

POST api/V1/tomorrow

Query Parameters

country  string optional  

One of supported country codes.

timezone  string optional  

PHP timezone. If nothing provided default TZ is 'Europe/Prague'.

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."
        ]
    }
}
 

Request      

GET api/V1/tomorrow

Query Parameters

country  string optional  

One of supported country codes.

timezone  string optional  

PHP timezone. If nothing provided default TZ is 'Europe/Prague'.

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."
        ]
    }
}
 

Request      

POST api/V1/yesterday

Query Parameters

country  string optional  

One of supported country codes.

timezone  string optional  

PHP timezone. If nothing provided default TZ is 'Europe/Prague'.

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."
        ]
    }
}
 

Request      

GET api/V1/yesterday

Query Parameters

country  string optional  

One of supported country codes.

timezone  string optional  

PHP timezone. If nothing provided default TZ is 'Europe/Prague'.

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"
        ]
    }
}
 

Request      

GET api/V1/getdate

Query Parameters

day  integer optional  

Valid day

month  integer optional  

Valid month

country  string optional  

One of supported country codes.

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"
        ]
    }
}
 

Request      

POST api/V1/getdate

Query Parameters

day  integer optional  

Valid day

month  integer optional  

Valid month

country  string optional  

One of supported country codes.

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."
        ]
    }
}
 

Request      

GET api/V1/getname

Query Parameters

name  string optional  

First name to look up

country  string optional  

One of supported country codes.

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."
        ]
    }
}
 

Request      

POST api/V1/getname

Query Parameters

name  string optional  

First name to look up

country  string optional  

One of supported country codes.