{"name":"Date & Time API","description":"Correct date/time math for apps and AI agents. Stateless. Returns JSON.","how_to_use":"Every endpoint is a GET request with query parameters and returns JSON. Build a request by appending the path and query string to base_url. Dates must be ISO-8601 (YYYY-MM-DD, optionally with THH:mm); timezones must be IANA names like 'Europe/Berlin'. Ambiguous slash-dates like 06/07/2026 are rejected, not guessed. On a 4xx the body has error.code, error.message and (often) error.expected — fix the named parameter and retry.","base_url":"https://datetime.open-api-market.com","docs":"https://datetime.open-api-market.com/docs","openapi":"/openapi.json","llms_txt":"https://datetime.open-api-market.com/llms.txt","mcp":"https://datetime.open-api-market.com/mcp","endpoints":[{"method":"GET","path":"/v1/convert","summary":"Convert a time between IANA timezones (DST-aware).","parameters":{"time":{"required":true,"type":"string","description":"ISO-8601 time, interpreted as local time in `from`.","example":"2026-06-07T15:00"},"from":{"required":true,"type":"string","description":"Source IANA timezone.","example":"Europe/Berlin"},"to":{"required":true,"type":"string","description":"Target IANA timezone.","example":"America/Detroit"}},"example_request":"https://datetime.open-api-market.com/v1/convert?time=2026-06-07T15:00&from=Europe/Berlin&to=America/Detroit","example_response":{"from":{"zone":"Europe/Berlin","time":"2026-06-07T15:00:00+02:00"},"to":{"zone":"America/Detroit","time":"2026-06-07T09:00:00-04:00","weekday":"Sunday","dst":true}}},{"method":"GET","path":"/v1/add","summary":"Add/subtract time from a date (optional skip=weekends).","parameters":{"date":{"required":true,"type":"string","description":"ISO-8601 date.","example":"2026-06-07"},"days":{"required":false,"type":"integer","description":"Days to add; negative subtracts. Provide at least one of days/weeks/months/years.","example":90},"weeks":{"required":false,"type":"integer"},"months":{"required":false,"type":"integer"},"years":{"required":false,"type":"integer"},"skip":{"required":false,"type":"string","enum":["weekends"],"description":"If `weekends`, the `days` component counts business days only."}},"example_request":"https://datetime.open-api-market.com/v1/add?date=2026-06-07&days=90&skip=weekends","example_response":{"result":"2026-10-09","weekday":"Friday"}},{"method":"GET","path":"/v1/diff","summary":"Difference between two dates (days|workdays|hours|minutes).","parameters":{"from":{"required":true,"type":"string","description":"ISO-8601 date.","example":"2026-01-01"},"to":{"required":true,"type":"string","description":"ISO-8601 date.","example":"2026-12-31"},"unit":{"required":false,"type":"string","enum":["days","workdays","hours","minutes"],"default":"days","description":"days/hours/minutes are signed (to − from); workdays counts working days in the inclusive range."}},"example_request":"https://datetime.open-api-market.com/v1/diff?from=2026-01-01&to=2026-12-31&unit=workdays","example_response":{"value":261,"unit":"workdays"}}],"errors":{"shape":{"error":{"code":"stable machine-readable string","message":"plain-English explanation","expected":"the format to use (when applicable)"}},"codes":{"MISSING_PARAM":"A required parameter was absent.","INVALID_DATE":"Not a valid ISO-8601 date.","AMBIGUOUS_DATE":"Slash-format date; order can't be assumed.","INVALID_TIMEZONE":"Not a known IANA timezone.","INVALID_NUMBER":"A numeric parameter was not an integer.","INVALID_PARAM":"A value was outside the allowed set.","NOT_FOUND":"No endpoint at that path."}}}