{"openapi":"3.1.0","info":{"title":"California Employer Payroll Extras API","version":"0.1.0","description":"California employer payroll items read from state agency pages: new-hire report window (DE 34), 2026 SDI, ETT and new-employer UI rates, paid sick leave accrual and cap. Tools: new_hire_report_due, payroll_tax_rates_2026, paid_sick_leave_rules, obligations_overview.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://us-ca-payroll-obligations.connectorbay.com/mcp.\n\nDisclaimer: General information only, not legal, tax, accounting or payment advice. California Employer Payroll Extras is an independent tool: it is not affiliated with, endorsed by or operated by any government body, central bank, standards body or scheme operator. Rates, thresholds and rules change; check the cited official source and confirm with a qualified professional before you rely on a result.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/us-ca-payroll-obligations/docs"},"termsOfService":"https://connectorbay.com/us-ca-payroll-obligations/terms"},"servers":[{"url":"https://us-ca-payroll-obligations.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/us-ca-payroll-obligations/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/new_hire_report_due":{"post":{"operationId":"new_hire_report_due","summary":"Return the last day to report a newly hired or rehired California employee to the EDD New Employee Registry (20 calendar","description":"Return the last day to report a newly hired or rehired California employee to the EDD New Employee Registry (20 calendar days from the start-of-work date) and the penalty amounts the EDD page states. Use for \"My employee started work in California on 3 November 2026. When must the DE 34 report be made\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start_of_work_date":{"description":"First day the employee performed services for wages, YYYY-MM-DD, between 2020-01-01 and 2035-12-31.","title":"Start Of Work Date","type":"string"}},"required":["start_of_work_date"],"title":"new_hire_report_dueArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/payroll_tax_rates_2026":{"post":{"operationId":"payroll_tax_rates_2026","summary":"Return the 2026 California SDI withholding rate, ETT rate and new-employer UI rate with their $7,000 or no-limit wage ba","description":"Return the 2026 California SDI withholding rate, ETT rate and new-employer UI rate with their $7,000 or no-limit wage bases, and optionally the amounts for one employee's 2026 wages. Use for \"What are the California SDI, ETT and new-employer UI rates for 2026\", \"What do SDI, ETT and UI come to on $50,000 of 2026 wages for one employee\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"annual_wages":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional one employee's wages for calendar 2026 in US dollars, a plain decimal (digits, at most 2 decimals; no $ sign or commas), at most 12 digits before the point.","title":"Annual Wages"}},"title":"payroll_tax_rates_2026Arguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/paid_sick_leave_rules":{"post":{"operationId":"paid_sick_leave_rules","summary":"Return the California paid sick leave accrual rule (1 hour per 30 hours worked), the 40 hour or 5 day use amount, the 80","description":"Return the California paid sick leave accrual rule (1 hour per 30 hours worked), the 40 hour or 5 day use amount, the 80 hour or 10 day accrual cap and the 90 day wait, and optionally the accrual for hours worked. Use for \"How much paid sick leave does a California employee accrue after 600 hours worked\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"hours_worked":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional hours worked so far, a plain decimal between 0 and 100000 with at most 2 decimals.","title":"Hours Worked"}},"title":"paid_sick_leave_rulesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/obligations_overview":{"post":{"operationId":"obligations_overview","summary":"List the California employer items this connector has read, each with its source URL, date read and what was not read (e","description":"List the California employer items this connector has read, each with its source URL, date read and what was not read (employer registration with the EDD was not readable). Use for \"Which California employer items can this tool answer\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"obligations_overviewArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}