# Hamro Patro Nepali Calendar API

> Nepali Bikram Sambat calendar by month with AD dates, tithi, panchanga, festivals and holidays

- Vendor: `hamropatronepalicalendarapi` · version 1.0 · category Content · tags nepali calendar api, bikram sambat api, nepal holidays api, tithi api, panchanga api, bs to ad date api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/hamropatronepalicalendarapi
- This document: https://apiclay.com/docs/hamropatronepalicalendarapi.md
- OpenAPI 3.1: https://apiclay.com/api/hamropatronepalicalendarapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `hamropatronepalicalendarapi`
- Updated: 2026-11-18

## About

## Hamro Patro Nepali Calendar API

The calendar behind Hamro Patro, Nepal's most used calendar app: any Bikram Sambat (BS) month laid out as weekly grid rows, each day with its Gregorian (AD) date, weekday, tithi, panchanga (nakshatra, yoga, karana, rashi, sunrise, sunset, moonrise and moonset), festivals and events in English and Nepali, and whether it is a public holiday. Useful for BS to AD date conversion and Nepal holiday lookups.

Data comes from **hamropatro.com** (https://www.hamropatro.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/month?year=2083&amp;month=9&amp;locale=en`; `prev` and `next` give the neighbouring months.

### Routes

#### GET `/month` - Calendar month
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| year | path | number | yes | Bikram Sambat year, e.g. `2083`. |
| month | path | number | yes | BS month, `1` (Baishakh) to `12` (Chaitra). |
| locale | query | string | no | `en` or `np` (Devanagari numerals). |

Returns: `yearBs`, `monthBs`, `monthNameEn`, `monthNameNp`, `daysInMonth`, `weekdayHeaders`, `prev`, `next`, and `days` (the grid cells of the weeks covering the month): `year_bs`, `month_bs`, `day_bs`, `year_ad`, `month_ad`, `day_ad`, `dayOfWeek`, `inMonth`, `isHoliday`, `isWeekendHoliday`, `tithiShort`, `panchanga` (tithi, paksha, nakshatra, yoga, karana, rashi, sunrise, sunset, moonrise, moonset as seconds after midnight), `patroEvent` (`titleEn`, `titleNp`, `items`, `isHoliday`).

### Caveats

- Panchanga times are Nepal local time. Festival and holiday listings are Hamro Patro's.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by hamropatro.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /month — Calendar month
- Gateway: `GET https://api.apiclay.com/v1/api/hamropatronepalicalendarapi/month`
- Public query params: `locale` (string), `year` (string, required), `month` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/hamropatronepalicalendarapi/month?year=<year>&month=<month>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
