Skip to main content
GET
Get discount

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"

deletedAt
required

When the discount was deleted, if applicable.

Example:

null

name
string
required

Display name of the discount.

Example:

"Buen Fin 20%"

description
string | null
required

Optional description of the discount.

Example:

null

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"

amountOff
integer | null
required

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

Example:

30000

percentageOff
number | null
required

Percentage to discount. Only set when type is PERCENTAGE.

Example:

20

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

expiresAt
required

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

Example:

null

maxApplications
integer | null
required

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

Example:

3