{"uid":"cap_nt1zgn4neqH3qRfol29A5","slug":"work-time-calc-pay-period-dates-52267010","name":"Work Time Calc – Pay Period Dates","description":"Pay-period start and end dates for weekly, biweekly, semi-monthly or monthly payroll, from any reference date.","url":"https://work-time-calc.x402tookit.com/pay-periods?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"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["type"],"properties":{"from":{"type":"string","description":"Date YYYY-MM-DD; the list starts at the period containing it (default today UTC)"},"type":{"type":"string","description":"weekly, biweekly, semi-monthly or monthly"},"count":{"type":"integer","description":"Number of periods, 1 to 60 (default 6)"},"anchor":{"type":"string","description":"Required for weekly and biweekly: the first day of any known period, YYYY-MM-DD"},"splitDay":{"type":"integer","description":"Semi-monthly only: day the second period starts, 2 to 28 (default 16: periods 1-15 and 16-end)"},"payDateLagDays":{"type":"integer","description":"Days after a period ends that pay is issued, 0 to 60 (adds payDate)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"type":{"type":["null","string"]},"source":{"type":["null","string"]},"periods":{"type":["array","null"],"items":{"type":"object","properties":{"end":{"type":["null","string"]},"days":{"type":["null","number"]},"start":{"type":["null","string"]},"number":{"type":["null","number"]},"payDate":{"type":["null","string"]},"endWeekday":{"type":["null","string"]},"startWeekday":{"type":["null","string"]}}}},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"containingPeriodEnd":{"type":["null","string"]},"containingPeriodStart":{"type":["null","string"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JBEygokq0uywkjZRPhs_d","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns pay-period start and end dates (and optional pay dates) for weekly, biweekly, semi-monthly, or monthly payroll schedules from any reference date.","exampleAgentPrompt":"Give me the next 8 biweekly pay periods starting from today, anchored on 2024-01-01, and include pay dates assuming we pay 2 days after each period ends.","exampleUseCases":[{"title":"Payroll calendar for HR automation","prompt":"Generate a full year of semi-monthly pay periods starting from January 1 2025 — I want 24 periods with the second half of each month starting on the 16th, and include pay dates assuming we pay 5 days after period end."},{"title":"Finding the current pay period","prompt":"What biweekly pay period does today fall in? Our anchor date is 2024-03-04 — just give me the current period's start and end dates."},{"title":"Monthly payroll schedule for finance team","prompt":"List the next 12 monthly pay periods from today so our finance team can plan disbursements, and add pay dates with a 3-day lag after each period closes."}],"resultDescription":"Returns a JSON object containing an array of pay periods, each with start date, end date, period number, day count, start/end weekday names, and optionally a computed pay date. Also includes the containing period start/end for the reference date, the schedule type, the as-of date, and a summary string.","failureModes":["Missing required 'type' parameter returns an error — weekly/biweekly/semi-monthly/monthly must be specified","Weekly or biweekly schedules without an 'anchor' parameter will fail or return an error — an anchor date is required to align the schedule","Invalid date format (not YYYY-MM-DD) causes a parsing error","count outside 1–60 range is rejected","splitDay outside 2–28 range is rejected for semi-monthly","payDateLagDays outside 0–60 range is rejected","Malformed query parameters may result in degraded or partial responses indicated by the 'degraded' flag"],"whenToPreferThis":"Use this endpoint when you need to enumerate concrete pay-period date ranges for any standard payroll frequency (weekly, biweekly, semi-monthly, monthly). It is purpose-built for payroll scheduling rather than generic date arithmetic — it understands payroll-specific concepts like anchor alignment for biweekly schedules, semi-monthly split days, and pay date lag. Prefer it over generic business-day calculators when the goal is generating a payroll calendar or identifying which pay period a given date belongs to.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:20:33.450Z","isFirstParty":false,"canonicalSlug":"work-time-calc-pay-period-dates-52267010"}