{"uid":"cap_ymqBeyV7Idh1J8IdrQ1Uj","slug":"open-holidays-subdivisions-lookup-273cc780","name":"Open Holidays Subdivisions Lookup","description":"Subdivision information per country for the `/open-holidays/v1/*` endpoints","url":"https://api.auor.io/open-holidays/v1/subdivisions","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":{"$ref":"https://api.auor.io/schemas/open-holidays/v1/subdivisions/input.json","type":"object","$schema":"https://json-schema.org/draft/2020-12/schema"}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"country":"DE"}}},"response":[{"code":"DE-BB","name":[{"text":"Brandenburg","language":"EN"}],"isoCode":"DE-BB","category":[{"text":"federal state","language":"EN"}],"shortName":"BB","officialLanguages":["DE"]},{"code":"DE-BE","name":[{"text":"Berlin","language":"EN"}],"isoCode":"DE-BE","category":[{"text":"federal state","language":"EN"}],"shortName":"BE","officialLanguages":["DE"]},{"code":"DE-BW","name":[{"text":"Baden-Württemberg","language":"EN"}],"isoCode":"DE-BW","category":[{"text":"federal state","language":"EN"}],"shortName":"BW","officialLanguages":["DE"]},{"code":"DE-BY","name":[{"text":"Bavaria","language":"EN"}],"isoCode":"DE-BY","category":[{"text":"federal state","language":"EN"}],"children":[{"code":"DE-BY-AU","name":[{"text":"Augsburg","language":"EN"}],"isoCode":"","category":[{"text":"municipality","language":"EN"}],"shortName":"BY-AU","officialLanguages":["DE"]}],"shortName":"BY","officialLanguages":["DE"]},{"code":"DE-HB","name":[{"text":"Bremen","language":"EN"}],"isoCode":"DE-HB","category":[{"text":"federal state","language":"EN"}],"shortName":"HB","officialLanguages":["DE"]},{"code":"DE-HE","name":[{"text":"Hesse","language":"EN"}],"isoCode":"DE-HE","category":[{"text":"federal state","language":"EN"}],"shortName":"HE","officialLanguages":["DE"]},{"code":"DE-HH","name":[{"text":"Hamburg","language":"EN"}],"isoCode":"DE-HH","category":[{"text":"federal state","language":"EN"}],"shortName":"HH","officialLanguages":["DE"]},{"code":"DE-MV","name":[{"text":"Mecklenburg-Western Pomerania","language":"EN"}],"groups":[{"code":"DE-MV-ABS","shortName":"MV-ABS"},{"code":"DE-MV-BBS","shortName":"MV-BBS"}],"isoCode":"DE-MV","category":[{"text":"federal state","language":"EN"}],"shortName":"MV","officialLanguages":["DE"]},{"code":"DE-NI","name":[{"text":"Lower Saxony","language":"EN"}],"isoCode":"DE-NI","category":[{"text":"federal state","language":"EN"}],"shortName":"NI","officialLanguages":["DE"]},{"code":"DE-NW","name":[{"text":"North Rhine-Westphalia","language":"EN"}],"isoCode":"DE-NW","category":[{"text":"federal state","language":"EN"}],"shortName":"NW","officialLanguages":["DE"]},{"code":"DE-RP","name":[{"text":"Rhineland-Palatinate","language":"EN"}],"isoCode":"DE-RP","category":[{"text":"federal state","language":"EN"}],"shortName":"RP","officialLanguages":["DE"]},{"code":"DE-SH","name":[{"text":"Schleswig-Holstein","language":"EN"}],"isoCode":"DE-SH","category":[{"text":"federal state","language":"EN"}],"shortName":"SH","officialLanguages":["DE"]},{"code":"DE-SL","name":[{"text":"Saarland","language":"EN"}],"isoCode":"DE-SL","category":[{"text":"federal state","language":"EN"}],"shortName":"SL","officialLanguages":["DE"]},{"code":"DE-SN","name":[{"text":"Saxony","language":"EN"}],"isoCode":"DE-SN","category":[{"text":"federal state","language":"EN"}],"shortName":"SN","officialLanguages":["DE"]},{"code":"DE-ST","name":[{"text":"Saxony-Anhalt","language":"EN"}],"isoCode":"DE-ST","category":[{"text":"federal state","language":"EN"}],"shortName":"ST","officialLanguages":["DE"]},{"code":"DE-TH","name":[{"text":"Thuringia","language":"EN"}],"isoCode":"DE-TH","category":[{"text":"federal state","language":"EN"}],"shortName":"TH","officialLanguages":["DE"]}]},"exampleRequest":{"country":"DE"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Z8Gj1JnD2_el_qzfomKif","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns subdivision (state/province/region) information for a given country, used to query open-holidays endpoints.","exampleAgentPrompt":"What subdivisions or states are available for Germany in the Open Holidays system so I can look up school holiday schedules?","exampleUseCases":[{"title":"Find all US states for holiday lookups","prompt":"I need to query school holidays across different states. Can you show me all the US states available in the Open Holidays system so I know which ones I can look up?"},{"title":"Discover Canadian provinces for holiday data","prompt":"We're expanding our holiday calendar tool to Canada. What provinces are supported in the Open Holidays API so we can fetch public holiday information for each one?"},{"title":"Check supported regions for Australian holidays","prompt":"I want to get holiday schedules for different parts of Australia. What subdivisions or territories can I query holiday data for in the Open Holidays system?"}],"resultDescription":"A list of subdivision objects for the specified country, each containing subdivision name, code, category (e.g. state, province, canton), and its parent country reference — used to parameterize further open-holidays API calls for school or public holiday data.","failureModes":["Invalid or unsupported country code returns empty list or 400 error","Missing required query parameters returns validation error","Country not covered by Open Holidays data returns empty result","Rate limiting or payment failure returns 402 or 429 error"],"whenToPreferThis":"Use this endpoint when you need to discover valid subdivision identifiers before querying school holiday or public holiday data for a specific country. It is a prerequisite lookup step for parameterizing other open-holidays endpoints that require a subdivision code.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:34:04.430Z","isFirstParty":false}