← Back to Skills Marketplace
Get public holidays by country and year
by
javainthinking
· GitHub ↗
· v1.0.0
553
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install apipick-public-holidays
Description
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....
README (SKILL.md)
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_KEYenv var as thex-api-keyheader 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
countryand optionalyear - Present the holidays as a sorted list with dates and names
See references/api_reference.md for full response field descriptions.
Usage Guidance
This skill is instruction-only and appears to only make authenticated requests to apipick.com using the APIPICK_API_KEY you provide. Before installing: (1) confirm you trust apipick.com and are willing to consume credits (the SKILL.md says 1 credit per request); (2) keep your APIPICK_API_KEY secret — do not paste it into public chat or share it; (3) expect the agent to prompt you for the key if the env var isn't set; (4) if you need stricter control, avoid allowing autonomous agent invocation or restrict when the skill can run. Because there is no packaged code, the main risk is accidental disclosure of your API key or unexpected API usage (billing/credits), not hidden binaries or downloads.
Capability Analysis
Type: OpenClaw Skill
Name: apipick-public-holidays
Version: 1.0.0
The skill bundle is designed to query public holidays from the apipick.com API. All files consistently describe this functionality, requiring an API key via an environment variable or user prompt. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, obfuscation, or prompt injection attempts against the AI agent. The instructions in SKILL.md are clear, directly related to the skill's stated purpose, and do not instruct the agent to perform any unauthorized or harmful actions.
Capability Assessment
Purpose & Capability
Name/description match the required resources and behavior. The only declared secret is APIPICK_API_KEY, which is exactly what's needed to call the apipick Public Holidays API.
Instruction Scope
SKILL.md instructs the agent to use the APIPICK_API_KEY header, convert names to ISO codes if needed, call https://www.apipick.com/api/holidays, and present results. It does not ask to read unrelated files, access other credentials, or contact unexpected endpoints.
Install Mechanism
No install spec and no code files — instruction-only skill. This minimizes disk/execute risk.
Credentials
Only APIPICK_API_KEY is required and declared as the primary credential. That single API key is proportional to the stated task. The SKILL.md uses that env var consistently.
Persistence & Privilege
always is false, no config paths requested, and the skill does not request persistent or elevated platform privileges. Autonomous invocation is enabled by default but not combined with other red flags.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install apipick-public-holidays - After installation, invoke the skill by name or use
/apipick-public-holidays - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
apipick-public-holidays 1.0.0 initial release:
- Query public holidays for 100+ countries by ISO country code and year.
- Returns sorted lists of holidays with official names and dates.
- Requires an apipick API key via the `APIPICK_API_KEY` environment variable.
- Supports country name to ISO code conversion.
- Ideal for checking holidays, planning, or verifying if a date is a holiday.
Metadata
Frequently Asked Questions
What is Get public holidays by country and year?
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.... It is an AI Agent Skill for Claude Code / OpenClaw, with 553 downloads so far.
How do I install Get public holidays by country and year?
Run "/install apipick-public-holidays" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Get public holidays by country and year free?
Yes, Get public holidays by country and year is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Get public holidays by country and year support?
Get public holidays by country and year is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Get public holidays by country and year?
It is built and maintained by javainthinking (@javainthinking); the current version is v1.0.0.
More Skills