Skip to main content
GET
Get a Premium
The response covers the premium’s price and fairMarketValue with their formatted variants, its remaining inventory, the recurring premium it maps to, and the otherMinimumAmounts that qualify a donor for it.

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Path Parameters

id
integer<int64>
required

The ID of the premium.

Response

OK

Represents a premium model.

id
integer<int64>

The unique identifier of the premium.

currency
string | null

The three-letter ISO currency code of the price and fair market value.

name
string | null

The name of the premium.

nameShort
string | null

The short name of the premium, used where space is limited.

code
string | null

The code of the premium.

description
string | null

The description of the premium.

isActive
boolean

Whether the premium is active.

price
number<double>

The amount a donor must give to receive the premium.

formattedPrice
string | null
read-only

The price, formatted for display in its currency.

fairMarketValue
number<double> | null

The fair market value of the premium, used for tax receipting.

formattedFairMarketValue
string | null
read-only

The fair market value, formatted for display in its currency.

inventory
integer<int32> | null

The number of units of the premium left in stock.

keepActiveWhenHasNoInventory
boolean

Whether the premium stays active when it has no inventory.

recurringPremiumId
integer<int64> | null

The unique identifier of the premium sent for recurring gifts instead.

recurringPremiumName
string | null

The name of the premium sent for recurring gifts instead.

image
string | null

The URL of the image shown for the premium.

externalIdentifier
string | null

An identifier of your own to store on the premium, for reconciling it with an external system.

otherMinimumAmounts
object[] | null

The minimum gift amounts that qualify for the premium in other currencies.

Last modified on July 28, 2026