{"uid":"cap_59UKPsipnZp5TUix7bsdc","slug":"darwin-business-calendar-business-days-counter-62a27805","name":"Darwin Business Calendar – Business Days Counter","description":"Count business days between two ISO dates, excluding weekends and public holidays.","url":"https://darwin-business-calendar.onrender.com/business-days","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":["start","end"],"properties":{"end":{"type":"string","description":"Inclusive end date in YYYY-MM-DD format"},"start":{"type":"string","description":"Inclusive start date in YYYY-MM-DD format"},"country":{"type":"string","default":"BR","description":"ISO 3166-1 alpha-2 country code"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["country","start","end","businessDays","excludedHolidays"],"properties":{"end":{"type":"string"},"start":{"type":"string"},"country":{"type":"string"},"businessDays":{"type":"integer"},"excludedHolidays":{"type":"array","items":{"type":"string"}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.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_iNN83URTyLdqrovJgfhAe","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":"Counts the number of business days between two ISO dates, excluding weekends and country-specific public holidays.","exampleAgentPrompt":"How many business days are there between January 15, 2025 and March 31, 2025 in Brazil, excluding weekends and public holidays?","exampleUseCases":[{"title":"Contract delivery deadline calculation","prompt":"Our contract says deliverables are due in 30 business days from February 3, 2025 — how many calendar days is that and can you count the actual business days between February 3 and March 17, 2025 for Brazil?"},{"title":"HR onboarding notice period check","prompt":"An employee gave notice on April 1, 2025 and their last day is April 30, 2025 — how many business days is that notice period in Brazil?"},{"title":"Invoice payment window verification","prompt":"Our invoice was issued on March 10, 2025 and payment is due May 10, 2025 — how many business days does the client actually have to pay, excluding Brazilian public holidays?"}],"resultDescription":"Returns a JSON object containing the country code, start date, end date, total number of business days in the range (as an integer), and an array of excluded public holiday dates that fell within the range.","failureModes":["Missing required 'start' or 'end' query parameter returns an error","Malformed date format (not YYYY-MM-DD) causes a parsing error","Invalid or unsupported country code may fall back to default (BR) or return an error","End date before start date may return zero or an error","Render.com cold-start latency on first request after inactivity"],"whenToPreferThis":"Choose this endpoint when you need a lightweight, low-cost API to compute exact business-day counts between two dates with country-specific holiday exclusions — particularly for Brazil (BR default). Ideal for contract, HR, invoicing, or project scheduling workflows where weekends and local holidays must be excluded. Prefer this over manual date arithmetic or generic calendar libraries when holiday accuracy for a specific country is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:35:44.573Z","isFirstParty":false}