How do I install the Apipick Public Holidays skill?

Run npx skillmds@latest add dvcrn/apipick-public-holidays in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Apipick Public Holidays safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Apipick Public Holidays?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Apipick Public Holidays free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Apipick Public Holidays?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Apipick Public Holidays by dvcrn — Agent Skill

Name: Apipick Public Holidays
Rating: 4.2 (5 reviews)
Author: dvcrn

Apipick Public Holidays

Query public holidays for any country and year using the apipick Public Holidays API. Supports 100+ countries identified by ISO 3166-1 alpha-2 country codes. Returns a sorted list of holidays with dates and official names. Use when the user wants to find public holidays for a country, check if a specific date is a holiday, list all national holidays for a given year, or plan around holidays in any country. Requires an apipick API key (x-api-key). Get a free key at https://www.apipick.com.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

apipick Public Holidays

Query public holidays for 100+ countries by ISO country code and year.

Endpoint

GET https://www.apipick.com/api/holidays

Authentication: x-api-key: YOUR_API_KEY header required. Get a free API key at https://www.apipick.com/dashboard/api-keys

Request Parameters

Parameter	Required	Description
`country`	Yes	ISO 3166-1 alpha-2 code (e.g. `US`, `GB`, `CN`, `DE`, `JP`)
`year`	No	4-digit year (defaults to current year). Range: 1900 to current year + 10

GET /api/holidays?country=US&year=2026

Response

{
  "success": true,
  "code": 200,
  "message": "Holidays retrieved successfully",
  "data": {
    "country": "US",
    "country_name": "United States",
    "year": 2026,
    "total": 11,
    "holidays": [
      {"date": "2026-01-01", "name": "New Year's Day"},
      {"date": "2026-07-04", "name": "Independence Day"},
      {"date": "2026-12-25", "name": "Christmas Day"}
    ]
  },
  "credits_used": 1,
  "remaining_credits": 99
}

Error Codes

Code	Meaning
400	Invalid country code or year
401	Missing or invalid API key
402	Insufficient credits

Cost: 1 credit per request

Usage Pattern

Use $APIPICK_API_KEY env var as the x-api-key header value; if not set, ask the user for their apipick API key
Convert a country name to ISO code if the user provides a full name (e.g. "China" → CN, "United Kingdom" → GB)
Make the GET request with country and optional year
Present the holidays as a sorted list with dates and names

See references/api_reference.md for full response field descriptions.

---name: apipick-public-holidaysdescription: Query public holidays for any country and year using the apipick Public Holidays API. Supports 100+ countries identified by ISO 3166-1 alpha-2 country codes. Returns a sorted list of holidays with dates and official names. Use when the user wants to find public holidays for a country, check if a specific date is a holiday, list all national holidays for a given year, or plan around holidays in any country. Requires an apipick API key (x-api-key). Get a free key at https://www.apipick.com.---# apipick Public HolidaysQuery public holidays for 100+ countries by ISO country code and year.## Endpoint```GET https://www.apipick.com/api/holidays```**Authentication:** `x-api-key: YOUR_API_KEY` header required.Get a free API key at https://www.apipick.com/dashboard/api-keys## Request Parameters| Parameter | Required | Description ||-----------|----------|-------------|| `country` | Yes | ISO 3166-1 alpha-2 code (e.g. `US`, `GB`, `CN`, `DE`, `JP`) || `year` | No | 4-digit year (defaults to current year). Range: 1900 to current year + 10 |```bashGET /api/holidays?country=US&year=2026```## Response```json{ "success": true, "code": 200, "message": "Holidays retrieved successfully", "data": { "country": "US", "country_name": "United States", "year": 2026, "total": 11, "holidays": [ {"date": "2026-01-01", "name": "New Year's Day"}, {"date": "2026-07-04", "name": "Independence Day"}, {"date": "2026-12-25", "name": "Christmas Day"} ] }, "credits_used": 1, "remaining_credits": 99}```## Error Codes| Code | Meaning ||------|---------|| 400 | Invalid country code or year || 401 | Missing or invalid API key || 402 | Insufficient credits |**Cost:** 1 credit per request## Usage Pattern1. Use `$APIPICK_API_KEY` env var as the `x-api-key` header value; if not set, ask the user for their apipick API key2. Convert a country name to ISO code if the user provides a full name (e.g. "China" → `CN`, "United Kingdom" → `GB`)3. Make the GET request with `country` and optional `year`4. Present the holidays as a sorted list with dates and namesSee [references/api_reference.md](references/api_reference.md) for full response field descriptions.

Frequently asked questions