---
title: "List"
method: GET
path: "/one_time_incentives/"
---

# List

`GET /one_time_incentives/`

## Request

- Base URL: `https://restapi.ordergroove.com`
- URL: `https://restapi.ordergroove.com/one_time_incentives/`
- Auth: one of:
  - none
  - API key in header `x-api-key`

Returns a list all of One Time Incentives attached to subscriptions for a merchant, or a list of one incentives for an individual customer.

## Query parameters

- `order` string
- `customer` string
- `external_code` string
- `item` string
- `created` string, date
- `created_start` string, date
- `created_end` string, date
- `last_updated` string, date
- `last_updated_start` string, date
- `last_updated_end` string, date
- `applied_at` string, date
- `applied_at_start` string, date
- `applied_at_end` string, date
- `include_item_level` boolean

## Response `200`

200

## Other responses

- `404`: 404

---

[API](https://skmtc.dev/ordergroove/apis/ordergroove-restrpc.md) - [All operations](https://skmtc.dev/ordergroove/apis/ordergroove-restrpc/llms.txt) - [OpenAPI document](https://skmtc.dev/ordergroove/apis/ordergroove-restrpc/revisions/ba97e740d08c?raw)