> ## Documentation Index
> Fetch the complete documentation index at: https://lava.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Nager.Date

> Public holiday API covering 100+ countries with holiday names, types (public, optional, bank), and long weekend calculations.

Public holiday API covering 100+ countries with holiday names, types (public, optional, bank), and long weekend calculations. Best for scheduling workflows that need to account for regional holidays — date validation, business day calculations, or travel planning. Free and no-auth.

2 example endpoints available through Lava's AI Gateway. See the [Nager.Date API docs](https://date.nager.at/Api) for full documentation.

<Info>This provider is **managed** — no additional setup required.</Info>

<Info>This is a **catch-all provider** — any valid URL under `https://date.nager.at/api/v3` is supported. Public holiday API. Construct URL as [https://date.nager.at/api/v3/\&#123;endpoint\&#125](https://date.nager.at/api/v3/\&#123;endpoint\&#125);. Common: /PublicHolidays/\{year}/\{countryCode}, /LongWeekend/\{year}/\{countryCode}, /CountryInfo/\{countryCode}. The endpoints below are curated examples.</Info>

## Endpoints

### List public holidays for a country and year

**GET** `https://date.nager.at/api/v3/PublicHolidays/2026/US` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://date.nager.at/api/v3/PublicHolidays/2026/US', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fdate.nager.at%2Fapi%2Fv3%2FPublicHolidays%2F2026%2FUS" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

### Check long weekends for a country and year

**GET** `https://date.nager.at/api/v3/LongWeekend/2026/US` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://date.nager.at/api/v3/LongWeekend/2026/US', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fdate.nager.at%2Fapi%2Fv3%2FLongWeekend%2F2026%2FUS" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

## Next Steps

<CardGroup cols={2}>
  <Card title="All Providers" icon="grid" href="/gateway/supported-providers">
    Browse all supported AI providers
  </Card>

  <Card title="Forward Proxy" icon="route" href="/gateway/forward-proxy">
    Learn how to construct proxy URLs and authenticate requests
  </Card>
</CardGroup>