beehiiv Developer Documentation

Retrieve a single tier belonging to a specific publication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

publicationIdstringRequiredformat: "^(pub_[0-9a-fA-F\-]+)$"

The prefixed ID of the publication object

tierIdstringRequiredformat: "^(tier_[0-9a-fA-F\-]+)$"

The prefixed ID of the tier object

expand[]stringOptional

Optional list of expandable objects.
stats - Returns statistics about the tier(s).
prices - Returns prices for the tier(s).

dataobject

The subscription tier object.

400

Bad Request Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

$	curl https://api.beehiiv.com/v2/publications/pub_00000000-0000-0000-0000-000000000000/tiers/tier_00000000-0000-0000-0000-000000000000 \
>	-H "Authorization: Bearer <token>"