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

# List Recurring Incentive

`GET /v1/incentives/recurring`

List all Recurring 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

- `status` string
- `type` string
- `note` string
- `page` integer
- `page_size` integer

## Headers

- `Authorization` string, required

## Response `201`

Success

- ListRecurringIncentivesResponse — Response schema listing many recurring_incentives
  - `data` object
    - `current_page` integer — The current page among all of the total_pages
    - `recurring_incentives` RecurringIncentive[]
      - `amount` integer, required — The recurring payment amount in the employment's currency, in cents.
      - `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.
      - `employment_id` string, required — The unique identifier (UUID) of the employment.
      - `end_date` string, date, nullable — The date the recurring incentive stops generating payments. Null for open-ended recurring incentives.
      - `id` string, required — The unique identifier (UUID) of the recurring incentive.
      - `note` string, nullable — An optional note describing the purpose of this recurring incentive.
      - `start_date` string, date, required — The date the recurring incentive starts generating payments.
      - `status` 'active' | 'inactive', required — Whether this recurring incentive is currently active and generating payments, or inactive (paused/ended).
      - `type` 'acting_up_allowance' | 'allowance' | 'car_allowance' | 'health_and_wellness_allowance' | 'internet_allowance' | 'meal_allowance' | 'on_call_allowance' | 'parenthood_allowance' | 'phone_allowance' | 'relocation_allowance' | 'travel_allowance' | 'work_from_home_allowance' | 'bonus' | 'holiday_bonus' | 'referral_bonus' | 'retention_bonus' | 'commission' | 'other' | 'overtime' | 'stipend', required — The type of recurring incentive (e.g., "meal_allowance", "housing_allowance").
    - `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/revisions/7e6a0c61ac82/schema)