Skip to main content
GET
/
v1
/
discounts
/
{id}
Get discount
curl --request GET \
  --url https://api.quentli.com/v1/discounts/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "disc_1234567890abcdefghij",
  "createdAt": "2025-01-01T00:00:00.000Z",
  "updatedAt": "2025-01-01T00:00:00.000Z",
  "name": "Buen Fin 20%",
  "organizationId": "org_1234567890abcdefghij",
  "type": "PERCENTAGE",
  "active": true,
  "oneOff": false,
  "deletedAt": null,
  "description": null,
  "amountOff": 30000,
  "percentageOff": 20,
  "expiresAt": null,
  "maxApplications": 3
}

Authorizations

​
Authorization
string
header
required

Organization API key using Authorization: Bearer sk_....

Path Parameters

​
id
string
required

Identifier of the discount.

Response

object | null

Discount details

Discount details. Returns null if not found.

​
id
string
required

Unique identifier of the discount.

Example:

"disc_1234567890abcdefghij"

​
createdAt
required

When the discount was created.

Example:

"2025-01-01T00:00:00.000Z"

​
updatedAt
required

When the discount was last updated.

Example:

"2025-01-01T00:00:00.000Z"

​
name
string
required

Display name of the discount.

Example:

"Buen Fin 20%"

​
organizationId
string
required

Identifier of the owning organization.

Example:

"org_1234567890abcdefghij"

​
type
enum<string>
required

Whether the discount is a fixed amount (FIXED) or a percentage (PERCENTAGE).

Available options:
FIXED,
PERCENTAGE
Example:

"PERCENTAGE"

​
active
boolean
required

Whether the discount is currently available for new applications.

Example:

true

​
oneOff
boolean
required

Whether this discount was created for a single-use custom charge.

Example:

false

​
deletedAt

When the discount was deleted, if applicable.

Example:

null

​
description
string | null

Optional description of the discount.

Example:

null

​
amountOff
integer | null

Fixed discount amount in minor currency units. Only set when type is FIXED.

Example:

30000

​
percentageOff
number | null

Percentage to discount. Only set when type is PERCENTAGE.

Example:

20

​
expiresAt

Optional date after which the discount can no longer be applied.

Example:

null

​
maxApplications
integer | null

Maximum total number of times this discount can be applied across all customers.

Example:

3