> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.kota.io/api-reference/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.kota.io/_mcp/server. # API Reference ## Docs - [API Errors](https://docs.kota.io/api-reference/errors.md): List of all potential API errors - [Managing Employee Salaries](https://docs.kota.io/api-reference/salaries.md): Create and retrieve dated salary records for employees. - [Contribution Reports](https://docs.kota.io/api-reference/contribution-reports.md): Understanding Contribution Reporting - [Events and Webhooks](https://docs.kota.io/api-reference/events-and-webhooks.md): Listen for events from API calls and Embedded UI sessions - [Working with Events](https://docs.kota.io/api-reference/events-and-webhooks/working-with-webhooks.md): Guide to working with events and webhooks ## API Docs - API Reference > Employers [List all employers](https://docs.kota.io/api-reference/employers/list-employers.md) - API Reference > Employers [Create an employer](https://docs.kota.io/api-reference/employers/create-employer.md) - API Reference > Employers [Retrieve an employer](https://docs.kota.io/api-reference/employers/retrieve-employer.md) - API Reference > Employers [Update an employer](https://docs.kota.io/api-reference/employers/update-employer.md) - API Reference > Employers [Offboard an employer](https://docs.kota.io/api-reference/employers/offboard-employer.md) - API Reference > Employees [List all employees](https://docs.kota.io/api-reference/employees/list-employees.md) - API Reference > Employees [Create an employee](https://docs.kota.io/api-reference/employees/create-employee.md) - API Reference > Employees [Retrieve an employee](https://docs.kota.io/api-reference/employees/retrieve-employee.md) - API Reference > Employees [Update an employee](https://docs.kota.io/api-reference/employees/update-employee.md) - API Reference > Employees [Offboard an employee](https://docs.kota.io/api-reference/employees/offboard-employee.md) - API Reference > Employees [Cancel offboarding an employee](https://docs.kota.io/api-reference/employees/cancel-offboarding-employee.md) - API Reference > Salaries [Create a salary record](https://docs.kota.io/api-reference/salaries/create-salary.md) - API Reference > Salaries [List salary records](https://docs.kota.io/api-reference/salaries/list-salaries.md) - API Reference > Salaries [Retrieve the current salary record](https://docs.kota.io/api-reference/salaries/retrieve-current-salary.md) - API Reference > Salaries [Retrieve a salary record](https://docs.kota.io/api-reference/salaries/retrieve-salary.md) - API Reference > Salaries [Delete a salary record](https://docs.kota.io/api-reference/salaries/delete-salary.md) - API Reference > Health Insurance [Retrieve employer quote](https://docs.kota.io/api-reference/health-insurance/retrieve-employer-health-insurance-quote.md) - API Reference > Health Insurance [List all employer quotes](https://docs.kota.io/api-reference/health-insurance/list-employer-health-insurance-quotes.md) - API Reference > Health Insurance [Retrieve an employer policy](https://docs.kota.io/api-reference/health-insurance/retrieve-employer-health-insurance-policy.md) - API Reference > Health Insurance [List all employer policies](https://docs.kota.io/api-reference/health-insurance/list-employer-health-insurance-policies.md) - API Reference > Health Insurance [Retrieve an employee offer](https://docs.kota.io/api-reference/health-insurance/retrieve-employee-health-insurance-offer.md) - API Reference > Health Insurance [List all employee offers](https://docs.kota.io/api-reference/health-insurance/list-employee-health-insurance-offers.md) - API Reference > Health Insurance [List all employee policies](https://docs.kota.io/api-reference/health-insurance/list-employee-health-insurance-policies.md) - API Reference > Health Insurance [Retrieve an employee policy](https://docs.kota.io/api-reference/health-insurance/retrieve-employee-health-insurance-policy.md) - API Reference > Requirements [Get a requirement](https://docs.kota.io/api-reference/requirements/get-requirement.md) - API Reference > Requirements [Submit answers](https://docs.kota.io/api-reference/requirements/submit-answers.md) - API Reference > Contribution Reports [Retrieve a contribution report](https://docs.kota.io/api-reference/contribution-reports/retrieve-contribution-report.md) - API Reference > Contribution Reports [List all contribution reports](https://docs.kota.io/api-reference/contribution-reports/list-contribution-reports.md) - API Reference > Contribution Reports [Finalize a contribution report](https://docs.kota.io/api-reference/contribution-reports/finalize-contribution-report.md) - API Reference > Contribution Reports [Retrieve an employee breakdown](https://docs.kota.io/api-reference/contribution-reports/retrieve-employee-breakdown-for-contribution-report.md) - API Reference > Contribution Reports [List all employee breakdowns](https://docs.kota.io/api-reference/contribution-reports/list-employee-breakdowns-for-contribution-report.md) - API Reference > Events and Webhooks [List all events](https://docs.kota.io/api-reference/events-and-webhooks/list-events.md) - API Reference > Events and Webhooks [Retrieve an event](https://docs.kota.io/api-reference/events-and-webhooks/retrieve-event.md) - API Reference > Events and Webhooks [List all webhook endpoints](https://docs.kota.io/api-reference/events-and-webhooks/list-webhook-endpoints.md) - API Reference > Events and Webhooks [Retrieve a webhook endpoint](https://docs.kota.io/api-reference/events-and-webhooks/retrieve-webhook-endpoint.md) - API Reference > Events and Webhooks > Types of Events [employee.created](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events/employee-created-webhook.md) - API Reference > Events and Webhooks > Types of Events [employee.updated](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events/employee-updated-webhook.md) - API Reference > Events and Webhooks > Types of Events [employee.offboarded](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events/employee-offboarded-webhook.md) - API Reference > Events and Webhooks > Types of Events [employer.created](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events/employer-created-webhook.md) - API Reference > Events and Webhooks > Types of Events [employer.updated](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events/employer-updated-webhook.md) - API Reference > Events and Webhooks > Types of Events [employer.offboarded](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events/employer-offboarded-webhook.md) - API Reference > Events and Webhooks > Types of Events [employer.health_insurance.quote.created](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events/employer-health-insurance-quote-created-webhook.md) - API Reference > Events and Webhooks > Types of Events [employer.health_insurance.quote.action_required](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events/employer-health-insurance-quote-action-required-webhook.md) - API Reference > Events and Webhooks > Types of Events [employer.health_insurance.quote.not_undertaken](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events/employer-health-insurance-quote-not-undertaken-webhook.md) - API Reference > Events and Webhooks > Types of Events [employer.health_insurance.quote.accepted](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events/employer-health-insurance-quote-accepted-webhook.md) - API Reference > Events and Webhooks > Types of Events [employer.health_insurance.quote.pending_quote](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events/employer-health-insurance-quote-pending-webhook.md) - API Reference > Events and Webhooks > Types of Events [employer.health_insurance.quote.pending_insurer_acceptance](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events/employer-health-insurance-quote-pending-insurer-acceptance-webhook.md) - API Reference > Events and Webhooks > Types of Events [employee.health_insurance.offer.action_required](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events/employee-health-insurance-offer-action-required-webhook.md) - API Reference > Events and Webhooks > Types of Events [employee.health_insurance.policy.activated](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events/employee-health-insurance-policy-activated-webhook.md) - API Reference > Events and Webhooks > Types of Events [employee.health_insurance.policy.cancelled](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events/employee-health-insurance-policy-cancelled-webhook.md) - API Reference > Events and Webhooks > Types of Events [employee.health_insurance.policy.expired](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events/employee-health-insurance-policy-expired-webhook.md) - API Reference > Events and Webhooks > Types of Events [contribution_report.finalized](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events/contribution-report-finalized-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [employee.created](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/employee-created-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [employee.updated](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/employee-updated-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [employee.offboarded](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/employee-offboarded-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [employer.created](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/employer-created-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [employer.updated](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/employer-updated-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [employer.offboarded](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/employer-offboarded-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [employer.health_insurance.quote.created](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/employer-health-insurance-quote-created-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [employer.health_insurance.quote.action_required](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/employer-health-insurance-quote-action-required-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [employer.health_insurance.quote.not_undertaken](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/employer-health-insurance-quote-not-undertaken-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [employer.health_insurance.quote.accepted](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/employer-health-insurance-quote-accepted-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [employer.health_insurance.quote.pending_quote](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/employer-health-insurance-quote-pending-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [employer.health_insurance.quote.pending_insurer_acceptance](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/employer-health-insurance-quote-pending-insurer-acceptance-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [employee.health_insurance.offer.action_required](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/employee-health-insurance-offer-action-required-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [employee.health_insurance.policy.activated](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/employee-health-insurance-policy-activated-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [employee.health_insurance.policy.cancelled](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/employee-health-insurance-policy-cancelled-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [employee.health_insurance.policy.expired](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/employee-health-insurance-policy-expired-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [employee.health_insurance.policy.imported](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/employee-health-insurance-policy-imported-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [contribution_report.finalized](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/contribution-report-finalized-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group.created](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-created-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group.ready](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-ready-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group.archived](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-archived-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group.updated](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-updated-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group.employee.added](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-employee-added-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group.employee.removed](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-employee-removed-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group.employee.eligible](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-employee-eligible-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group.employee.moved](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-employee-moved-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group.employee.move.scheduled](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-employee-move-scheduled-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [policy.scheduled](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/policy-scheduled-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [policy.active](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/policy-active-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [policy.imported](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/policy-imported-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [policy.expired](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/policy-expired-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [policy.cancelled](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/policy-cancelled-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [policy.updated](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/policy-updated-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [policy.finalized_by_provider](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/policy-finalized-by-provider-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [policy.renewal.opened](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/policy-renewal-opened-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [policy.renewal.renewed](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/policy-renewal-renewed-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [policy.renewal.canceled](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/policy-renewal-canceled-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_policy.scheduled](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-policy-scheduled-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_policy.active](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-policy-active-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_policy.expired](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-policy-expired-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_policy.cancelled](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-policy-cancelled-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_policy.updated](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-policy-updated-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_policy.renewal.opened](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-policy-renewal-opened-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_policy.renewal.renewed](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-policy-renewal-renewed-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_policy.renewal.canceled](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-policy-renewal-canceled-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [enrolment_intent.processing](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/enrolment-intent-processing-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [enrolment_intent.scheduled](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/enrolment-intent-scheduled-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [enrolment_intent.action_required](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/enrolment-intent-action-required-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [enrolment_intent.enrolling](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/enrolment-intent-enrolling-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [enrolment_intent.enrolled](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/enrolment-intent-enrolled-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [enrolment_intent.not_undertaken](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/enrolment-intent-not-undertaken-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [enrolment_intent.ineligible](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/enrolment-intent-ineligible-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [enrolment_intent.pending_confirmation](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/enrolment-intent-pending-confirmation-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [enrolment_intent.coverage_options_required](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/enrolment-intent-coverage-options-required-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [policy_amendment_intent.action_required](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/policy-amendment-intent-action-required-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [policy_amendment_intent.awaiting_quote](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/policy-amendment-intent-awaiting-quote-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [policy_amendment_intent.pending_confirmation](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/policy-amendment-intent-pending-confirmation-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [policy_amendment_intent.processing](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/policy-amendment-intent-processing-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [policy_amendment_intent.amended](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/policy-amendment-intent-amended-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [policy_amendment_intent.processing_error](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/policy-amendment-intent-processing-error-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [policy_amendment_intent.not_undertaken](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/policy-amendment-intent-not-undertaken-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [dependents_management_intent.action_required](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/dependents-management-intent-action-required-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [dependents_management_intent.completed](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/dependents-management-intent-completed-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [dependents_management_intent.not_undertaken](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/dependents-management-intent-not-undertaken-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [dependents_management_intent.dependent.pending_confirmation](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/dependents-management-intent-dependent-pending-confirmation-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [dependents_management_intent.dependent.action_required](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/dependents-management-intent-dependent-action-required-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [dependents_management_intent.dependent.ineligible](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/dependents-management-intent-dependent-ineligible-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [dependents_management_intent.dependent.processing](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/dependents-management-intent-dependent-processing-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [dependents_management_intent.dependent.restricted](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/dependents-management-intent-dependent-restricted-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [dependents_management_intent.dependent.ready](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/dependents-management-intent-dependent-ready-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [policy_import_intent.processing](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/policy-import-intent-processing-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [policy_import_intent.success](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/policy-import-intent-success-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [policy_import_intent.failed](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/policy-import-intent-failed-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_quote_intent.processing](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-quote-intent-processing-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_quote_intent.action_required](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-quote-intent-action-required-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_quote_intent.awaiting_quote](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-quote-intent-awaiting-quote-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_quote_intent.quote_available](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-quote-intent-quote-available-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_quote_intent.rejected](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-quote-intent-rejected-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_quote_intent.rejected_by_insurer](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-quote-intent-rejected-by-insurer-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_quote_intent.quote_expired](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-quote-intent-quote-expired-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_policy_intent.processing](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-policy-intent-processing-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_policy_intent.action_required](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-policy-intent-action-required-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_policy_intent.pending_provider_approval](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-policy-intent-pending-provider-approval-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_policy_intent.policy_created](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-policy-intent-policy-created-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_policy_intent.expired](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-policy-intent-expired-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_policy_intent.provider_rejected](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-policy-intent-provider-rejected-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [group_policy_intent.manual_renewal_gathering_required](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/group-policy-intent-manual-renewal-gathering-required-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [associated_person.updated](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/associated-person-updated-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [invoice.created](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/invoice-created-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [invoice.updated](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/invoice-updated-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [invoice.deleted](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/invoice-deleted-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [employee.salary_created](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/employee-salary-created-v-2-webhook.md) - API Reference > Events and Webhooks > Types of Events V2 [employee.salary_deleted](https://docs.kota.io/api-reference/events-and-webhooks/types-of-events-v-2/employee-salary-deleted-v-2-webhook.md) - API Reference > Embed Sessions [Get Embedded SDK token](https://docs.kota.io/api-reference/embed-sessions/create-embed-session.md) - API Reference > Associated Persons [List associated persons](https://docs.kota.io/api-reference/associated-persons/list-associated-persons.md) - API Reference > Associated Persons [Create an associated person](https://docs.kota.io/api-reference/associated-persons/create-associated-person.md) - API Reference > Associated Persons [Retrieve an associated person](https://docs.kota.io/api-reference/associated-persons/retrieve-associated-person.md) - API Reference > Associated Persons [Update an associated person](https://docs.kota.io/api-reference/associated-persons/update-associated-person.md) - API Reference > Associated Persons [Delete an associated person](https://docs.kota.io/api-reference/associated-persons/delete-associated-person.md) - API Reference > Dependents Management Intents [Retrieve a dependents management intent](https://docs.kota.io/api-reference/dependents-management-intents/retrieve-dependents-management-intent.md) - API Reference > Dependents Management Intents [Retrieve associated persons eligibility for a dependents management intent](https://docs.kota.io/api-reference/dependents-management-intents/get-associated-persons-eligibility.md) - API Reference > Dependents Management Intents [Add dependents to a dependents management intent](https://docs.kota.io/api-reference/dependents-management-intents/add-dependents-to-dependents-management-intent.md) - API Reference > Dependents Management Intents [Remove a dependent from a Dependents Management Intent](https://docs.kota.io/api-reference/dependents-management-intents/remove-dependent-from-dependents-management-intent.md) - API Reference > Dependents Management Intents [Confirm dependent list](https://docs.kota.io/api-reference/dependents-management-intents/confirm-dependents-management-intent.md) - API Reference > Dependents Management Intents [Cancel the dependents management intent](https://docs.kota.io/api-reference/dependents-management-intents/cancel-dependents-management-intent.md) - API Reference > Enrolment Intents [List all enrolment intents](https://docs.kota.io/api-reference/enrolment-intents/list-enrolment-intents.md) - API Reference > Enrolment Intents [Create a new enrolment intent](https://docs.kota.io/api-reference/enrolment-intents/create-enrolment-intent.md) - API Reference > Enrolment Intents [Retrieve an enrolment intent](https://docs.kota.io/api-reference/enrolment-intents/retrieve-enrolment-intent.md) - API Reference > Enrolment Intents [Update policy configuration enrolment intent](https://docs.kota.io/api-reference/enrolment-intents/update-enrolment-intent-configuration.md) - API Reference > Enrolment Intents [List requirements for an enrolment intent](https://docs.kota.io/api-reference/enrolment-intents/list-enrolment-intent-requirements.md) - API Reference > Enrolment Intents [Confirm an enrolment intent](https://docs.kota.io/api-reference/enrolment-intents/confirm-enrolment-intent.md) - API Reference > Enrolment Intents [Reject an enrolment intent](https://docs.kota.io/api-reference/enrolment-intents/reject-enrolment-intent.md) - API Reference > Enrolment Intents [Submit coverage selections for an enrolment intent](https://docs.kota.io/api-reference/enrolment-intents/submit-enrolment-intent-coverage-selections.md) - API Reference > Enrolment Intents [Create a dependents management intent for an enrolment intent](https://docs.kota.io/api-reference/enrolment-intents/create-dependents-management-intent-for-enrolment-intent.md) - API Reference > Events [Replay an event](https://docs.kota.io/api-reference/events/replay-event.md) - API Reference > Group Policies [List all group policies](https://docs.kota.io/api-reference/group-policies/list-group-policies.md) - API Reference > Group Policies [Retrieve a group policy](https://docs.kota.io/api-reference/group-policies/retrieve-group-policy.md) - API Reference > Group Policy Intents [List group policy intents](https://docs.kota.io/api-reference/group-policy-intents/list-group-policy-intents.md) - API Reference > Group Policy Intents [Create a group policy intent](https://docs.kota.io/api-reference/group-policy-intents/create-group-policy-intent.md) - API Reference > Group Policy Intents [Retrieve a group policy intent](https://docs.kota.io/api-reference/group-policy-intents/retrieve-group-policy-intent.md) - API Reference > Group Policy Intents [List requirements for a group policy intent](https://docs.kota.io/api-reference/group-policy-intents/list-group-policy-intent-requirements.md) - API Reference > Group Quote Intents [List group quote intents](https://docs.kota.io/api-reference/group-quote-intents/list-group-quote-intents.md) - API Reference > Group Quote Intents [Create a group quote intent](https://docs.kota.io/api-reference/group-quote-intents/create-group-quote-intent.md) - API Reference > Group Quote Intents [Retrieve a group quote intent](https://docs.kota.io/api-reference/group-quote-intents/retrieve-group-quote-intent.md) - API Reference > Group Quote Intents [List requirements for a group quote intent](https://docs.kota.io/api-reference/group-quote-intents/list-group-quote-intent-requirements.md) - API Reference > Group Quote Intents [Retrieve the quote for a group quote intent](https://docs.kota.io/api-reference/group-quote-intents/get-group-quote-intent-quote.md) - API Reference > Group Quote Intents [Reject a group quote intent](https://docs.kota.io/api-reference/group-quote-intents/reject-group-quote-intent.md) - API Reference > Groups [List all groups](https://docs.kota.io/api-reference/groups/list-groups.md) - API Reference > Groups [Create a group](https://docs.kota.io/api-reference/groups/create-group.md) - API Reference > Groups [Retrieve a group](https://docs.kota.io/api-reference/groups/retrieve-group.md) - API Reference > Groups [Update a group](https://docs.kota.io/api-reference/groups/update-group.md) - API Reference > Groups [List employees in a group](https://docs.kota.io/api-reference/groups/list-group-employees.md) - API Reference > Groups [Add an employee to a group](https://docs.kota.io/api-reference/groups/add-employee-to-group.md) - API Reference > Groups [Check employee eligibility for a group](https://docs.kota.io/api-reference/groups/check-group-eligibility.md) - API Reference > Hosted Sessions [Get One-off Hosted Session Link](https://docs.kota.io/api-reference/hosted-sessions/create-hosted-session.md) - API Reference > Plans [List all plans](https://docs.kota.io/api-reference/plans/list-plans.md) - API Reference > Plans [Retrieve a plan](https://docs.kota.io/api-reference/plans/retrieve-plan.md) - API Reference > Policies [List all policies](https://docs.kota.io/api-reference/policies/list-policies.md) - API Reference > Policies [Retrieve a policy](https://docs.kota.io/api-reference/policies/retrieve-policy.md) - API Reference > Policy Amendment Intents [List all policy amendment intents for a policy](https://docs.kota.io/api-reference/policy-amendment-intents/list-policy-amendment-intents.md) - API Reference > Policy Amendment Intents [Create a new policy amendment intent](https://docs.kota.io/api-reference/policy-amendment-intents/create-policy-amendment-intent.md) - API Reference > Policy Amendment Intents [Retrieve a policy amendment intent](https://docs.kota.io/api-reference/policy-amendment-intents/retrieve-policy-amendment-intent.md) - API Reference > Policy Amendment Intents [Confirm policy amendment intent](https://docs.kota.io/api-reference/policy-amendment-intents/confirm-policy-amendment-intent.md) - API Reference > Policy Amendment Intents [Cancel a policy amendment intent](https://docs.kota.io/api-reference/policy-amendment-intents/cancel-policy-amendment-intent.md) - API Reference > Policy Amendment Intents [Create a dependents management intent for a policy amendment](https://docs.kota.io/api-reference/policy-amendment-intents/create-dependents-management-intent-for-policy-amendment.md) - API Reference > Policy Import Intents [List all policy import intents](https://docs.kota.io/api-reference/policy-import-intents/list-policy-import-intents.md) - API Reference > Policy Import Intents [Create a new policy import intent](https://docs.kota.io/api-reference/policy-import-intents/create-policy-import-intent.md) - API Reference > Policy Import Intents [Retrieve a policy import intent](https://docs.kota.io/api-reference/policy-import-intents/retrieve-policy-import-intent.md) - API Reference > Providers [List all providers](https://docs.kota.io/api-reference/providers/list-providers.md) - API Reference > Providers [Retrieve a provider](https://docs.kota.io/api-reference/providers/retrieve-provider.md) ## OpenAPI Specification The raw OpenAPI 3.1 specification for this API is available at: - [OpenAPI JSON](https://docs.kota.io/openapi.json) - [OpenAPI YAML](https://docs.kota.io/openapi.yaml) > **Note:** This page contains both a page directory (above) and the landing page content (below). The page directory is generated for agent use and does not appear on the landing page. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.kota.io/api-reference/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.kota.io/_mcp/server. # API Introduction > Introduction to the Kota API ## Introduction We've designed Kota Embedded around payroll, employer of record and HR platforms with specific use-cases available to different platforms so you don't have to worry about compliance and can focus on offering a great customer experience. ### Scoping out an integration? Check out our documentation to [plan your integration](/get-started/api-basics). ##### Base URL #### Production ```text https://api.kota.io ``` #### Test ```text https://test.api.kota.io ``` --- ## Authentication The Kota API uses API keys to authenticate requests. Test mode secret keys have the prefix `pk_test_` and live mode secret keys have the prefix `pk_live_`. Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth. Authentication to the API is performed via Bearer Auth. Provide your API key as the bearer token value in the Authorization header. Use `-H "Authorization: Bearer YOUR_API_SECRET_KEY"` in your request. All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail. API keys are tied to an individual platform and are restricted to that platform's type, such as `employer_of_record` and `payroll_provider`. Some endpoints are restricted to specific types and they are clearly noted in this API reference. **`AUTHENTICATED REQUEST`** ```curl AUTHENTICATED REQUEST curl https://api.kota.io/ENDPOINT \ -H "Authorization: Bearer YOUR_API_SECRET_KEY" \ ``` --- ## Errors Kota uses conventional HTTP response codes to indicate the success or failure of an API request. In general: * Codes in the `2xx` range indicate success. * Codes in the `4xx` range indicate an error that failed given the information provided (e.g., a required parameter was omitted). You should not retry the same request, except for the `429` status code. * Codes in the `5xx` range indicate an error with Kota's servers (these are rare). You can retry the same request. [Learn more about specific errors here](/api-reference/errors). ### The Error object In the event of an error, Kota will return an error object conform to the [Problem Details for HTTP APIs specification](https://www.rfc-editor.org/rfc/rfc9457.html). The error object has at the following properties. Additional properties may be included for specific errors, see the [detailed error documentation](/api-reference/errors). #### Properties typestring A URI reference that identifies the problem type. title string A short, human-readable summary of the problem type. status integer The HTTP status code generated by the server for this occurrence of the problem. error_code string A specific error code representing the error condition. trace_id stringOptional A unique identifier for this particular occurrence of the problem, for troubleshooting purposes. detail stringOptional A human-readable explanation specific to this occurrence of the problem. errors objectOptional An object containing error messages related to specific request properties.
HTTP STATUS CODE SUMMARY
200 OK Everything worked as expected.
400 Bad Request The request was unacceptable, often due to missing a required parameter.
401 Unauthorized No valid API key provided.
403 Forbidden The API key doesn’t have permissions to perform the request.
404 Not Found The requested resource doesn’t exist.
429 Too Many Requests Too many requests hit the API too quickly. We recommend an exponential backoff of your requests.
500 Server Error Something went wrong on Kota's end. (These are rare.)
--- ## Idempotent requests The API supports idempotency for safely retrying requests without accidentally performing the same operation twice. When creating or updating an object, use an idempotency key. Then, if a connection error occurs, you can safely repeat the request without risk of creating a second object or performing the update twice. To perform an idempotent request, provide an additional header to the request: `"Idempotency-Key: YOUR_IDEMPOTENT_KEY"` The idempotency key is a unique identifier that Kota's servers use to recognize subsequent retries of the same request. How you create unique keys is up to you, but we suggest using V4 UUIDs, or another random string with at least 30 characters of entropy to avoid collisions. Idempotency keys are linked with your authentication token and are up to 200 characters long with an expiration of 1 hour. The idempotency layer compares incoming parameters to those of the original request. If the parameters match we'll return exactly the same response as before without re-executing the request. If they do not match it will return a [409 Conflict](/api-reference/errors#idempotency-error) error to prevent accidental misuse. We save results only after the execution of an endpoint completes successfully. If incoming parameters fail validation, or the request conflicts with another request that’s executing concurrently we will discard the data of the subsequent request. You can retry these requests. All POST requests accept idempotency keys. Don’t send idempotency keys in GET, PUT and DELETE requests because it has no effect. These requests are idempotent by definition. **`IDEMPOTENT REQUEST`** ```curl IDEMPOTENT REQUEST curl https://api.kota.io/ENDPOINT \ -H "Authorization: Bearer YOUR_API_SECRET_KEY" \ -H "Idempotency-Key: KG5LxwFBepaKHyUD" \ ```