AgentDataFeed Public Holidays API

openapi: 3.2.0
info:
  title: agentdatafeed Public Holidays API
  version: 1.10.0
  description: Paid per-query factual datasets for AI agents.
  x-guidance: 'Free, no payment: GET /v1/datasets for the catalogue and GET /v1/{dataset}/sample for 5 current records. Paid: GET /v1/{dataset} with the query filters listed per operation, one x402 payment per call (USDC on Base), up to 100 records. Free feedback: POST /v1/feedback (why you did not buy, or which data you want). MCP server: https://agentdatafeed.com/mcp. Datasets: amsterdam-events (Amsterdam events, $0.005); security-advisories (Security advisories, $0.003); vulnerability-watch (Vulnerability watch, $0.003); eu-tenders (EU public tenders, $0.01); uk-tenders (UK public tenders, $0.005); eu-funding (EU funding calls and grants, $0.005); cert-advisories (European CERT security advisories, $0.003); eu-medicines (EU medicines: authorisations, shortages, safety communications and referrals (EMA), $0.005); sanctions-entities (Sanctioned entities, vessels and aircraft (EU and OFAC lists), $0.005); product-recalls (Product recalls and safety alerts (US FDA, US CPSC, US NHTSA, Health Canada, Transport Canada, CFIA, UK FSA, UK OPSS), $0.005); eu-legislation (EU legislation: new and amended acts in the Official Journal (regulations, directives, decisions), $0.005); drug-shortages (Medicine shortages (US FDA, EMA), $0.005); public-holidays (Public and bank holidays (official government lists, current and next year), $0.002).'
  contact:
    name: agentdatafeed
    email: ops@agentdatafeed.com
    url: https://agentdatafeed.com
servers:
- url: https://agentdatafeed.com
tags:
- name: Public Holidays
paths:
  /v1/public-holidays:
    get:
      operationId: query_public_holidays
      summary: Public and bank holidays (official government lists, current and next year)…
      description: 'Official public and bank holidays for the current and the next calendar year, taken only from government publications and open government data: United Kingdom (GOV.UK bank holidays for England, Wales, Scotland and Northern Ireland), France (Etalab, metropolitan list plus the extra days in Alsace-Moselle and the overseas departments and collectivities), United States (OPM federal holidays), Japan (Cabinet Office), Singapore (Ministry of Manpower), Luxembourg, Hong Kong (1823), Slovenia and Malta. Regional holidays carry an ISO 3166-2 region code; nationwide holidays have region null. Filter by country, region, date range, year and type. Fields: country, region, date, year, local name and language, English name where published, type (public or bank), day off where the source states it, notes such as substitute day, authority, official link, verification, paid placement.'
      parameters:
      - name: country
        in: query
        required: false
        schema:
          type: string
        description: 'ISO 3166-1 alpha-2 code or comma-separated codes: GB, FR, US, JP, SG, LU, HK, SI, MT (UK is accepted for GB)'
      - name: region
        in: query
        required: false
        schema:
          type: string
        description: ISO 3166-2 code, for example GB-SCT or FR-974; returns that region's holidays plus the nationwide holidays of its country
      - name: date_from
        in: query
        required: false
        schema:
          type: string
        description: ISO date; holidays on or after this date
      - name: date_to
        in: query
        required: false
        schema:
          type: string
        description: ISO date; holidays on or before this date
      - name: year
        in: query
        required: false
        schema:
          type: string
        description: Calendar year, for example 2026
      - name: type
        in: query
        required: false
        schema:
          type: string
        description: public or bank
      - name: q
        in: query
        required: false
        schema:
          type: string
        description: Text in the local or English name (case-insensitive)
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: 1 to 100, default 50
      - name: offset
        in: query
        required: false
        schema:
          type: string
        description: Default 0
      responses:
        '200':
          description: Matching records
        '402':
          description: x402 payment required; see accepts[]
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.002'
        protocols:
        - x402: {}
      tags:
      - Public Holidays
  /v1/public-holidays/sample:
    get:
      operationId: sample_public_holidays
      summary: Public and bank holidays (official government lists, current and next year)…
      security: []
      responses:
        '200':
          description: Sample
      tags:
      - Public Holidays