{"uid":"cap_OadXCEhm7M-4hJG3f1K4p","slug":"saylor-innovations-natural-language-date-parser-375f8826","name":"Saylor Innovations Natural Language Date Parser","description":"Turn a phrase like next Friday at 3pm, in 3 weeks or end of next month into an ISO date and time relative to a base, with weekday and ambiguity notes","url":"https://saylorinnovations.com/api/time/parse-date?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["text"],"properties":{"base":{"type":"string","description":"optional ISO date or datetime to measure from, default now"},"text":{"type":"string","description":"Date phrase such as tomorrow, next friday at 3pm, in 3 weeks, end of next month, 5 March 2027, Q3 2026"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["date","weekday"],"properties":{"base":{"type":"string","description":"Base asset or base currency"},"date":{"type":"string","description":"Date (YYYY-MM-DD)"},"note":{"type":"string","description":"Caveat or context for reading the result"},"time":{"type":["string","null"],"description":"Time"},"input":{"type":"string","description":"Phrase as supplied"},"notes":{"type":"array","description":"Interpretation notes such as the date order assumed"},"range":{"type":["object","null"],"description":"Range covered by the data"},"source":{"type":"string","description":"Data source the values come from"},"weekday":{"type":"string","description":"Day of the week"},"datetime":{"type":["string","null"],"description":"Full UTC timestamp when the phrase included a time, otherwise null"},"ambiguous":{"type":"boolean","description":"True when the phrase could be read two ways (for example 3/4/2027)"},"checked_at":{"type":"string","description":"Time the check was run (UTC)"},"days_from_base":{"type":"number","description":"Days from base"}},"additionalProperties":true},"description":{"type":"string"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oZdC4fBosmBkrlLHH0P-V","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts natural language date/time phrases (e.g. 'next Friday at 3pm', 'end of next month') into ISO dates and times relative to an optional base date, with weekday, ambiguity flags, and interpretation notes","exampleAgentPrompt":"What exact date does 'end of next month' resolve to, and what day of the week is it? Use today as the base.","exampleUseCases":[{"title":"Scheduling assistant date resolution","prompt":"The user said they want the meeting 'in 3 weeks on a Friday' — can you resolve that to an actual ISO date so I can create the calendar invite?"},{"title":"Disambiguating user-entered deadline","prompt":"A user typed '3/4/2027' as their project deadline. Can you parse that and tell me if it's ambiguous, what date it resolves to, and what day of the week it falls on?"},{"title":"Relative date from a specific anchor","prompt":"Starting from March 15 2026, what ISO date does 'end of next month' resolve to, and how many days away is that from the base date?"}],"resultDescription":"A JSON object containing the resolved ISO date (YYYY-MM-DD), the day of the week, an optional full UTC datetime when a time was included in the phrase, the original input phrase, the base used, days from the base, an ambiguous flag (true if the phrase could be read multiple ways), interpretation notes array, and an optional range object for period phrases like 'Q3 2026'.","failureModes":["Unrecognizable phrase returns an error or null date","Missing required 'text' query parameter returns a 400-level error","Ambiguous phrases like '3/4/2027' succeed but set ambiguous:true with a note about assumed date order","Invalid base date format may cause a parsing error or fallback to server time","Timezone-sensitive phrases without explicit timezone may resolve differently depending on server locale"],"whenToPreferThis":"Choose this endpoint when you need to convert a human-typed or spoken relative date phrase into a structured ISO date, especially when the phrase uses natural language like 'next Friday', 'in 3 weeks', or 'end of next month'. It is ideal when you also need ambiguity detection (e.g. for date formats like 3/4/2027), weekday information, or the ability to anchor the resolution to a specific base date rather than the current moment. Prefer it over generic date libraries when you want a hosted, stateless service with interpretive notes included in the response.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-21T12:39:35.651Z","isFirstParty":false,"canonicalSlug":"saylor-innovations-natural-language-date-parser-375f8826"}