beehiiv Developer Documentation

Retrieve all tiers belonging to a specific publication

Authentication

AuthorizationBearer

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

Path parameters

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

The prefixed ID of the publication object

Query parameters

expand[]stringOptional

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

limitintegerOptional

A limit on the number of objects to be returned. The limit can range between 1 and 100, and the default is 10.

pageintegerOptional

Pagination returns the results in pages. Each page contains the number of results specified by the limit (default: 10).
If not specified, results 1-10 from page 1 will be returned.

directionenumOptionalDefaults to asc

The direction that the results are sorted in. Defaults to asc
asc - Ascending, sorts from smallest to largest.
desc - Descending, sorts from largest to smallest.

Allowed values:

Response

datalist of objects

limitinteger

The limit placed on the results. If no limit was specified in the request,this defaults to 10.

pageinteger>=0Defaults to 1

The page number the results are from. If no page was specified in the request, this defaults to page 1.

total_resultsinteger

The total number of results from all pages.

total_pagesinteger

The total number of pages.

Errors

400

Bad Request Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

1	{
2	"data": [
3	{
4	"id": "tier_3f9a1b2c-4d5e-678f-9012-abcdef345678",
5	"name": "Gold",
6	"status": "active",
7	"description": "Access to all premium articles and monthly newsletters",
8	"stats": {
9	"active_subscriptions": 1250
10	},
11	"prices": [
12	{
13	"id": "price_7a8b9c0d-1e2f-3456-7890-abcdef123456",
14	"amount_cents": 999
15	}
16	]
17	}
18	],
19	"limit": 1,
20	"page": 1,
21	"total_results": 3,
22	"total_pages": 3
23	}

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