🎂
Namedays
API Documentation

Getting Started

Welcome to the Nameday API documentation. Learn how to integrate name day data from 20+ countries into your applications.

🔑

Authentication

Learn how to authenticate your API requests

🔗

API Endpoints

Explore all available endpoints and their parameters

⚡

Rate Limits

Understand API rate limits and pricing tiers

💻

Code Examples

Get started quickly with ready-to-use code examples

Overview

The Nameday API provides access to comprehensive name day data across multiple countries and traditions. Whether you're building a calendar application, a social networking platform, or a reminder service, our API makes it easy to integrate culturally-relevant name day celebrations.

Key Features

  • 20+ Countries: Access name day data from Greece, Poland, Hungary, Slovakia, and many more
  • Multiple Traditions: Orthodox, Catholic, Protestant, and civil calendars
  • RESTful API: Simple HTTP endpoints with JSON responses
  • Fast & Reliable: Globally distributed with 99.9% uptime SLA
  • Generous Free Tier: Start building without a credit card

Quick Example

Here's a simple example to get today's namedays for Greece:

curl -X GET 'https://name.birrday.com/api/v1/namedays?country=GR&date=2024-01-07' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Base URL

https://name.birrday.com/api/v1

Next Steps

  1. Set up authentication to get your API key
  2. Explore the available endpoints
  3. Check out code examples in your preferred language

Need Help?

If you have questions or need assistance, we're here to help.

Contact Support