{"uid":"cap_zDoa7lMcnNWFXfqBNUd2J","slug":"country-calendar-preferences-lookup-deae8bf4","name":"Country Calendar Preferences Lookup","description":"A crossing for play, feeling, language, science and computation — creating states that do not have names yet.","url":"https://api.lilambd.com/calendars/countries/%7Biso2%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"},"additionalProperties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{"country":{"first_day":"sat","weekend_end":"fri","country_iso2":"IR","weekend_start":"fri","calendars_preferred":"persian gregorian islamic"},"week_rule":{},"calendars_in_use":[{"calendar_id":"persian"}]},"attribution":"..."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hwCH9lEY1qT9kBE5Uao2X","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the preferred calendars, first day of the week, and weekend start/end days for a given country by ISO2 code.","exampleAgentPrompt":"What calendar system, first day of the week, and weekend days does Iran use? Look it up by its country code IR.","exampleUseCases":[{"title":"Localize scheduling app for new market","prompt":"We're launching our scheduling app in Saudi Arabia — can you look up what calendar system SA uses, which day the week starts, and what days count as the weekend there?"},{"title":"Display correct week start in calendar UI","prompt":"I need to build a calendar view for users in Israel. What's the first day of the week in IL and what are the weekend days?"},{"title":"Validate regional calendar support","prompt":"Does our app need to support the Persian calendar for users in Iran? Pull up the preferred calendars for IR so I can check."}],"resultDescription":"A JSON object containing the country's preferred calendar systems (e.g. persian, gregorian, islamic), the first day of the week, the weekend start and end days, the country ISO2 code, and an attribution field. Also includes a list of calendars currently in use in that country.","failureModes":["Invalid or unsupported ISO2 country code returns an error or empty result","Unrecognized country code may return a 404 or empty data object","Network timeout or service unavailability returns a 5xx error","Malformed request (missing path parameter) returns a 400 error"],"whenToPreferThis":"Use this endpoint when you need country-specific calendar system preferences, week start day, or weekend day configuration for localization, scheduling, or internationalization purposes. Prefer this over manual lookup tables when you need machine-readable, structured calendar metadata keyed by ISO2 country code.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:36:07.863Z","isFirstParty":false,"canonicalSlug":"country-calendar-preferences-lookup-deae8bf4"}