Auth36

Billing8

Channels45

Connections7

Debug1

Discovery7

Donations4

Emojis2

Experiments1

Gateway1

Geolocation1

GIFs5

GIFs (Deprecated)10

Gifts2

Guilds45

Instance1

Invites6

Messages1

OAuth220

Premium12

Read States2

Reports6

Saved Media7

Search1

Stickers2

Themes1

Users99

Voice1

Webhooks16

Premium

Get Stripe price IDs

Retrieves Stripe price IDs for premium subscriptions based on geographic location.

get/premium/price-ids

Query parameters

country_codestring

Two-letter country code for regional pricing. Only used when the server cannot geolocate the request; otherwise the request GeoIP country wins.

Response

Success

monthlystring nullable

Stripe price ID for the monthly subscription

yearlystring nullable

Stripe price ID for the yearly subscription

gift_1_monthstring nullable

Stripe price ID for the 1 month gift

gift_1_yearstring nullable

Stripe price ID for the 1 year gift

monthly_amount_minorinteger nullable

Monthly price amount in the currency minor unit

yearly_amount_minorinteger nullable

Yearly price amount in the currency minor unit

gift_1_month_amount_minorinteger nullable

Gift 1 month price amount in the currency minor unit

gift_1_year_amount_minorinteger nullable

Gift 1 year price amount in the currency minor unit

currency'USD' | 'EUR' | 'BRL' | 'DKK' | 'INR' | 'NOK' | 'PLN' | 'SEK' | 'TRY' required

gift_currency'USD' | 'EUR' | 'BRL' | 'DKK' | 'INR' | 'NOK' | 'PLN' | 'SEK' | 'TRY' required

Changes

Changed in 5 of the 21 revisions of this API.41716

Sep 18, 2026dd0ad4ea1c8844See the full diff
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ○
  response property gift_1_month list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property gift_1_year list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property monthly list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property yearly list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
Sep 11, 2026b7b12069ba8d1See the full diff
- ●
  deleted the query request parameter pricing_mode
  request-parameter-removed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 6, 2026a52a2cf49d9b16See the full diff
- ●
  added the new IP_BAN_DECLINED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IP_BAN_DECLINED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_COUNTRY_NOT_SUPPORTED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_COUNTRY_NOT_SUPPORTED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_GATE_ESCAPE_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_GATE_ESCAPE_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_INBOUND_VERIFICATION_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_INBOUND_VERIFICATION_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_LOOKUP_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_LOOKUP_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_IN_SERVICE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_IN_SERVICE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_MOBILE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_MOBILE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_VERIFICATION_NEEDS_REVIEW enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_VERIFICATION_NEEDS_REVIEW enum value to the response property for the response status
  response-property-enum-value-added
This revision's changelog hit the recording limit, so it may not list every change to this endpoint.
Sep 5, 20264dbb738a3e222See the full diff
- ○
  removed the NSFW_EMOJI_STICKER_BLOCKED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the NSFW_EMOJI_STICKER_BLOCKED enum value from the response property for the response status
  response-property-enum-value-removed
Sep 3, 2026fa36b1b48ca510See the full diff
- ○
  removed the INVALID_PACK_TYPE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_PACK_TYPE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACKS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACKS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACK_EXPRESSIONS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACK_EXPRESSIONS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the PACK_ACCESS_DENIED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the PACK_ACCESS_DENIED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the UNKNOWN_PACK enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the UNKNOWN_PACK enum value from the response property for the response status
  response-property-enum-value-removed
This revision also has 17 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 21 revisions, 2 have no diff computed.

Full history