API Endpoints

Complete reference for all available API endpoints.

https://name.birrday.com/api

All API requests require authentication via API key. Include your key in the x-api-key header.

x-api-key: YOUR_API_KEY

Available Endpoints

The Nameday API provides the following endpoints for accessing name day data:

Retrieve name day data for a specific country and date. Supports filtering by country, date range, and calendar tradition.

Search for when a specific name is celebrated. Returns all matching name days across different countries and traditions.

Most endpoints support the following common parameters:

Parameter	Type	Description
`country`	string	ISO 3166-1 alpha-2 country code (e.g., `GR`, `PL`, `HU`)
`date`	string	Date in ISO 8601 format (e.g., `2024-01-07`)
`tradition`	string	Calendar tradition (e.g., `orthodox`, `catholic`)

All successful API responses return JSON with the following structure:

{
  "data": [ /* array of results */ ],
  "meta": {
    "count": 10,
    "country": "GR",
    "date": "2024-01-07"
  }
}

Error responses follow a consistent format:

{
  "error": "Error type",
  "message": "Human-readable error message",
  "statusCode": 400
}

200

Request succeeded

400

Invalid parameters or request format

401

Missing or invalid API key

429

Rate limit exceeded

500

Something went wrong on our end