---
title: "Get incentive code"
method: GET
path: "/companies/{company_key}/incentives/codes/{incentive_code}"
tags: ["Incentive Code API"]
---

# Get incentive code

`GET /companies/{company_key}/incentives/codes/{incentive_code}`

## Path parameters

- `company_key` string, required
- `incentive_code` string, required

## Headers

- `X-API-Version` string
- `Content-Type` string, required

## Response `200`

Successful response

- IncentiveCodeResponse
  - `code` string — The incentive code.
  - `active` boolean — Whether issuance of the incentive code is currently allowed.
  - `issuances` object
    - `total` integer — The total number of times this code has been issued.
    - `unique` integer — The number of unique times this code has been issued.
  - `redemptions` object
    - `total` integer — The total number of times this code has been redeemed.
    - `unique` integer — The number of unique times this code has been redeemed.
  - `created_at` string — The date this code was created, in the ISO-8601 format.
  - `updated_at` string — The date this code was last updated, in the ISO-8601 format.
  - `url` string

---

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