{"uid":"cap_uDG1dZ8ODbJNVAPDT2iLx","slug":"trusted-information-api-public-holidays-lookup-8677093c","name":"Trusted Information API — Public Holidays Lookup","description":"Pay-per-call UK company, property and crypto market data for AI agents via x402. Official sources, no signup, no API keys, failed calls never charged.","url":"https://api.trustedinformation.site/api/geo/holidays","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["country"],"properties":{"year":{"type":"string","description":"Year (default current)"},"country":{"type":"string","description":"ISO 2-letter country code, e.g. GB, US, DE"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["country","year","holidays"],"properties":{"next":{"type":["object","null"]},"year":{"type":"number"},"count":{"type":"number"},"country":{"type":"string"},"holidays":{"type":"array"}}}}}}},"responseSchema":{"type":"json","example":{"next":{"date":"2026-08-31","name":"Summer Bank Holiday"},"year":2026,"count":14,"source":"Nager.Date public holidays","country":"GB","holidays":[{"date":"2026-01-01","name":"New Year's Day","regions":["GB-ENG","GB-SCT","GB-WLS","GB-NIR"],"localName":"New Year's Day","nationwide":false}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RShHTEaQ7-0PYHi4Q2Uzo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a list of public holidays for a given country and year, including the next upcoming holiday.","exampleAgentPrompt":"What are all the public holidays in the UK for 2025, and which one is coming up next?","exampleUseCases":[{"title":"HR payroll bank holiday planning","prompt":"Can you get me the full list of UK public holidays for 2025 so I can check which days our payroll runs need to be adjusted?"},{"title":"Scheduling meetings across borders","prompt":"I need to know all the public holidays in Germany for 2026 — I'm planning a project timeline and want to avoid scheduling key deadlines on bank holidays."},{"title":"Next bank holiday countdown","prompt":"When is the next public holiday in Great Britain? I want to know the date and name so I can plan a long weekend trip."}],"resultDescription":"A JSON object containing the country code, year, total holiday count, a full array of holidays (each with date, local name, English name, regions, and nationwide flag), and a 'next' field pointing to the nearest upcoming holiday with its date and name. Data is sourced from Nager.Date public holidays.","failureModes":["Missing or invalid 'country' query parameter returns an error — country is required","Unsupported country code returns empty or error response","Invalid year format may return an error or default to current year","Network timeout or upstream Nager.Date unavailability could cause failed call (not charged)"],"whenToPreferThis":"Choose this endpoint when you need structured, per-country public holiday data without signup or API keys, billed only on success at $0.002 USDC per call via x402. It is ideal for agents that need to check upcoming holidays, build scheduling logic, or enrich calendars across multiple countries. Prefer over manual scraping or free-tier APIs when you need reliable official-source data with pay-per-use pricing and no subscription overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:40:13.632Z","isFirstParty":false}