---
title: "Payment"
method: GET
path: "/employer/payment"
tags: ["Payroll"]
---

# Payment

`GET /employer/payment`

Read payroll and contractor related payments by the company.

## Query parameters

- `entity_ids` string[]
- `start_date` string, date, required
- `end_date` string, date, required

## Headers

- `Finch-API-Version` string, date, required

## Response `200`

Payment data

- object[]
  - `id` string, uuid, required — The unique id for the payment.
  - `pay_period` object, nullable, required — The pay period object.
    - `start_date` string, nullable, required
    - `end_date` string, nullable, required
  - `pay_date` string, nullable, required
  - `debit_date` string, nullable, required
  - `company_debit` Money, nullable, required
    - `amount` integer, nullable, required — Amount for money object (in cents)
    - `currency` string, required
  - `gross_pay` Money, nullable, required
    - `amount` integer, nullable, required — Amount for money object (in cents)
    - `currency` string, required
  - `net_pay` Money, nullable, required
    - `amount` integer, nullable, required — Amount for money object (in cents)
    - `currency` string, required
  - `employer_taxes` Money, nullable, required
    - `amount` integer, nullable, required — Amount for money object (in cents)
    - `currency` string, required
  - `employee_taxes` Money, nullable, required
    - `amount` integer, nullable, required — Amount for money object (in cents)
    - `currency` string, required
  - `individual_ids` string[], nullable, required — Array of every individual on this payment.
  - `pay_group_ids` string[], nullable, required — Array of the Finch id (uuidv4) of every pay group associated with this payment.
  - `pay_frequencies` PayFrequency[], nullable, required — List of pay frequencies associated with this payment.

## Other responses

- `202` — The request has been accepted for processing, but data is not yet available

## Changes

> 53 revisions in range; 3 could not be searched.

- **2025-10-27** `0105d239fcaf` — 1 info
  - added the new optional `query` request parameter `entity_ids`
- **2025-06-24** `f7e741bc6e01` — 25 info
  - the response property `items/company_debit` became required for the status `200`
  - the response property `items/company_debit/amount` became required for the status `200`
  - the response property `items/company_debit/currency` became required for the status `200`
  - the response property `items/debit_date` became required for the status `200`
  - …21 more
- **2025-04-22** `46640c1b4688` — 1 info
  - the endpoint scheme security `bearerAuth` was added to the API

[Change history](https://skmtc.dev/finch-api/apis/api-reference/changes/employer/payment/get.md)

---

[API](https://skmtc.dev/finch-api/apis/api-reference.md) · [All operations](https://skmtc.dev/finch-api/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/finch-api/api-reference/revisions/f1cca2cb0ef2/schema)