---
title: "List Incentives"
method: GET
path: "/v1/incentives"
tags: ["Incentives"]
---

# List Incentives

`GET /v1/incentives`

Lists all Incentives of a company

## Scopes

| Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|
| Manage expenses (`employment_payments`) | View incentives (`incentive:read`) | Manage incentives (`incentive:write`) |

## Query parameters

- `employment_id` string
- `status` string
- `recurring_incentive_id` string
- `page` integer
- `page_size` integer

## Headers

- `Authorization` string, required

## Response `200`

Success

- ListIncentivesResponse — Response schema listing many incentives
  - `data` object
    - `current_page` integer — The current page among all of the total_pages
    - `incentives` Incentive[]
      - `amount` integer, required — The incentive amount in the employment's currency, in cents. For example, EUR 500.25 would be represented as 50025.
      - `amount_tax_type` 'gross' | 'net', required — Whether the amount given accounts for taxes or not. `gross` indicates that the amount given is the amount to be paid before taxes are subtracted. `net` indicates that the amount given is the amount which will be paid to the employee after taxes. Remote will gross this up to ensure the taxes are included and employee receives the amount requested without further reduction.
      - `effective_date` string, date, nullable, required — The date the incentive takes effect. Determines which payroll cycle the incentive will be paid in.
      - `employment_id` string, required — The unique identifier (UUID) of the employment this incentive belongs to.
      - `expected_payout_date` string, date, nullable — The expected date when this incentive will be paid to the employee. Null if not yet determined.
      - `id` string, required — The unique identifier (UUID) of the incentive.
      - `note` string, nullable — An optional note describing the reason or context for this incentive.
      - `period_end` string, date, nullable — The end date of the period this incentive covers. Null for non-periodic incentives.
      - `period_start` string, date, nullable — The start date of the period this incentive covers (e.g., for quarterly bonuses). Null for non-periodic incentives.
      - `recurring_incentive_id` string, nullable — If this incentive was generated from a recurring incentive schedule, this is the ID of the parent recurring incentive. Null for one-time incentives.
      - `status` string, required — The current status of the incentive (e.g., "pending", "scheduled", "paid", "cancelled").
      - `type` string, required — The type of incentive (e.g., "signing_bonus", "performance_bonus", "commission", "referral_bonus").
    - `total_count` integer — The total number of records in the result
    - `total_pages` integer — The total number of pages the user can go through

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `429` — Too many requests

---

[API](https://skmtc.net/remote-com/apis/remote.md) · [All operations](https://skmtc.net/remote-com/apis/remote/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/remote-com/remote/versions/7e6a0c61ac82/schema)