---
title: "contribution_report.finalized"
method: POST
path: "ContributionReportFinalizedWebhook"
tags: ["Types of events"]
---

# contribution_report.finalized

`POST ContributionReportFinalizedWebhook` (webhook)

## Payload

- ContributionReportFinalizedWebhook
  - `id` string, required
  - `type` string, required
  - `platform_id` string, required
  - `data` ContributionReportResponse, required
    - `object` string — The object type
    - `id` string, required — Unique identifier for the contribution report
    - `employer_id` string, required — Unique identifier of the employer for which the report is created
    - `external_customer_id` string, 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.
    - `period` GetContributionReportPeriod, required
      - `from_date` string, date, required — Start date of the period
      - `to_date` string, date, required — End date of the period
    - `status` 'open' | 'finalized', required
    - `finalized_at` string, date-time, nullable — Date and time the report was finalized, if applicable
    - `created_at` string, date-time, required — Date and time the report was created
    - `last_updated_at` string, date-time, required — Date and time of the last update to the report
  - `created_at` string, date-time, required
  - `object` string, required
  - `api_version` string, required

## Acknowledgement `2xx`

Your server implementation should return this HTTP status code if the data was received successfully

## Other responses

- `4xx` — If your server returns an HTTP status code indicating it does not understand the format of the payload the delivery will be treated as a failure. Multiple retries will be attempted!
- `5xx` — If your server returns an HTTP status code indicating a server-side error the delivery will be treated as a failure. Multiple retries will be attempted!

---

[API](https://skmtc.net/kota/apis/kota-api.md) · [All operations](https://skmtc.net/kota/apis/kota-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kota/kota-api/revisions/7b8b3ed87c96/schema)