Contribution Reports

Finalize a contribution report

Changed on

This endpoint finalizes the contribution report object, making it immutable and preventing any further updates. Once finalized, its status changes to finalized, and it serves as a historical record for payroll reporting. Any changes or adjustments that occur after the finalization will roll into the next reporting period.

post/contribution_reports/{contribution_report_id}/finalize

Request

  • Base URL
    https://test.api.kota.io
  • URL
    https://test.api.kota.io/contribution_reports/{contribution_report_id}/finalize
  • Auth
    HTTP bearer

Path parameters

contribution_report_idstring required
Example:ctr_3b1333d87d9d4fd6ad83ba7f6b0e951a

Response

OK

objectstring

The object type

idstring required

Unique identifier for the contribution report

employer_idstring required

Unique identifier of the employer for which the report is created

external_customer_idstring nullable

Unique identifier of the customer for which the report is created. This identifier is assigned by the Employer of Record (EoR) platform to the Customer (i.e. the company using the EoR service) for which the employee is employed. This parameter is only available to EoR platforms.

status'open' | 'finalized' required
finalized_atstring date-time nullable

Date and time the report was finalized, if applicable

file_idstring nullable

Identifier of the report's downloadable CSV file. Null until the CSV has been prepared, which happens shortly after the report is finalized — use file_status to tell whether it is still on its way. Exchange it for a download link via GET /files/{file_id}/download_link.

file_status'pending' | 'ready' | 'failed'
created_atstring date-time required

Date and time the report was created

last_updated_atstring date-time required

Date and time of the last update to the report

Example response

{
  "id": "ctr_3b1333d87d9d4fd6ad83ba7f6b0e951a",
  "employer_id": "er_3b1333d87d9d4fd6ad83ba7f6b0e951a",
  "period": {
    "from_date": "2024-12-01",
    "to_date": "2024-12-01"
  },
  "finalized_at": "2024-12-01T00:00:00Z",
  "file_id": "file_3b1333d87d9d4fd6ad83ba7f6b0e951a",
  "created_at": "2024-12-01T00:00:00Z",
  "last_updated_at": "2024-12-01T00:00:00Z",
  "aggregates": {
    "employee_count": 123,
    "totals": [
      {
        "total_amount": 123.45,
        "employer_amount": 123.45,
        "employee_amount": 123.45
      }
    ]
  }
}

Changes