{"openapi":"3.1.0","info":{"title":"Business Day & Deadline API","version":"0.1.0","description":"Verified, always-current business-day arithmetic for ~200 countries incl. subdivisions (German Bundeslaender, US states) and correct per-country weekend rules (e.g. Fri/Sat in Egypt). Informational only — verify legally binding deadlines with the competent authority. Not legal advice.","x-guidance":"All endpoints are GET with query parameters and cost $0.001 via x402 (USDC on Base). Use /v1/check to test if a date is a business day, /v1/add to add or subtract N business days to a date (deadline calculation), /v1/between to count business days between two dates, /v1/next and /v1/previous to roll to the nearest business day. Dates are ISO YYYY-MM-DD, country is ISO 3166-1 alpha-2 (DE, US, JP), region is an optional ISO 3166-2 subdivision suffix (BY for Bavaria, CA for California). Every response carries verifiedAt and source for auditability. GET /v1/schema and GET /health are free.","contact":{"email":"paulos@voiceagenten.com"}},"paths":{"/v1/check":{"get":{"operationId":"checkBusinessDay","summary":"Is a given date a business day in a country/region?","tags":["BusinessDays"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"date","in":"query","required":true,"description":"ISO date YYYY-MM-DD","schema":{"type":"string"}},{"name":"country","in":"query","required":true,"description":"ISO 3166-1 alpha-2 country code, e.g. DE, US, JP","schema":{"type":"string"}},{"name":"region","in":"query","required":false,"description":"Optional ISO 3166-2 subdivision suffix, e.g. BY (Bavaria), CA (California)","schema":{"type":"string"}},{"name":"weekend","in":"query","required":false,"description":"Optional weekend override: sat-sun | fri-sat | custom:THU,FRI","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string"},"isBusinessDay":{"type":"boolean"},"reason":{"type":["string","null"],"enum":["weekend","holiday",null]},"holidayName":{"type":["string","null"]},"country":{"type":"string"},"region":{"type":["string","null"]},"source":{"type":"string"},"verifiedAt":{"type":"string"},"disclaimer":{"type":"string"}},"required":["date","isBusinessDay"]}}}},"402":{"description":"Payment Required"}}}},"/v1/add":{"get":{"operationId":"addBusinessDays","summary":"Add or subtract N business days to a date (deadline calculation)","tags":["BusinessDays"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"start","in":"query","required":true,"description":"ISO start date YYYY-MM-DD","schema":{"type":"string"}},{"name":"days","in":"query","required":true,"description":"Business days to add (negative = subtract)","schema":{"type":"integer"}},{"name":"country","in":"query","required":true,"description":"ISO 3166-1 alpha-2 country code, e.g. DE, US, JP","schema":{"type":"string"}},{"name":"region","in":"query","required":false,"description":"Optional ISO 3166-2 subdivision suffix, e.g. BY (Bavaria), CA (California)","schema":{"type":"string"}},{"name":"weekend","in":"query","required":false,"description":"Optional weekend override: sat-sun | fri-sat | custom:THU,FRI","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"start":{"type":"string"},"days":{"type":"integer"},"resultDate":{"type":"string"},"skipped":{"type":"array","items":{"type":"object"}},"country":{"type":"string"},"region":{"type":["string","null"]},"source":{"type":"string"},"verifiedAt":{"type":"string"},"disclaimer":{"type":"string"}},"required":["resultDate"]}}}},"402":{"description":"Payment Required"}}}},"/v1/between":{"get":{"operationId":"businessDaysBetween","summary":"Count business days between two dates (exclusive-from, inclusive-to)","tags":["BusinessDays"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"from","in":"query","required":true,"description":"ISO date YYYY-MM-DD","schema":{"type":"string"}},{"name":"to","in":"query","required":true,"description":"ISO date YYYY-MM-DD","schema":{"type":"string"}},{"name":"country","in":"query","required":true,"description":"ISO 3166-1 alpha-2 country code, e.g. DE, US, JP","schema":{"type":"string"}},{"name":"region","in":"query","required":false,"description":"Optional ISO 3166-2 subdivision suffix, e.g. BY (Bavaria), CA (California)","schema":{"type":"string"}},{"name":"weekend","in":"query","required":false,"description":"Optional weekend override: sat-sun | fri-sat | custom:THU,FRI","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"businessDays":{"type":"integer"},"calendarDays":{"type":"integer"},"holidays":{"type":"array","items":{"type":"object"}},"country":{"type":"string"},"region":{"type":["string","null"]},"source":{"type":"string"},"verifiedAt":{"type":"string"},"disclaimer":{"type":"string"}},"required":["businessDays"]}}}},"402":{"description":"Payment Required"}}}},"/v1/next":{"get":{"operationId":"nextBusinessDay","summary":"Next business day after a date","tags":["BusinessDays"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"date","in":"query","required":true,"description":"ISO date YYYY-MM-DD","schema":{"type":"string"}},{"name":"country","in":"query","required":true,"description":"ISO 3166-1 alpha-2 country code, e.g. DE, US, JP","schema":{"type":"string"}},{"name":"region","in":"query","required":false,"description":"Optional ISO 3166-2 subdivision suffix, e.g. BY (Bavaria), CA (California)","schema":{"type":"string"}},{"name":"weekend","in":"query","required":false,"description":"Optional weekend override: sat-sun | fri-sat | custom:THU,FRI","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"nextBusinessDay":{"type":"string"},"country":{"type":"string"},"region":{"type":["string","null"]},"source":{"type":"string"},"verifiedAt":{"type":"string"},"disclaimer":{"type":"string"}},"required":["nextBusinessDay"]}}}},"402":{"description":"Payment Required"}}}},"/v1/previous":{"get":{"operationId":"previousBusinessDay","summary":"Previous business day before a date","tags":["BusinessDays"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"date","in":"query","required":true,"description":"ISO date YYYY-MM-DD","schema":{"type":"string"}},{"name":"country","in":"query","required":true,"description":"ISO 3166-1 alpha-2 country code, e.g. DE, US, JP","schema":{"type":"string"}},{"name":"region","in":"query","required":false,"description":"Optional ISO 3166-2 subdivision suffix, e.g. BY (Bavaria), CA (California)","schema":{"type":"string"}},{"name":"weekend","in":"query","required":false,"description":"Optional weekend override: sat-sun | fri-sat | custom:THU,FRI","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"previousBusinessDay":{"type":"string"},"country":{"type":"string"},"region":{"type":["string","null"]},"source":{"type":"string"},"verifiedAt":{"type":"string"},"disclaimer":{"type":"string"}},"required":["previousBusinessDay"]}}}},"402":{"description":"Payment Required"}}}},"/health":{"get":{"operationId":"health","summary":"Free health and data-freshness check","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"dataGeneratedAt":{"type":"string"}},"required":["status"]}}}}}}}}}