{
"opencollection": "1.0.0",
"info": {
"name": "API Reference subpackage_advertisement_opportunities subpackage_tiers API",
"version": "1.0.0"
},
"items": [
{
"info": {
"name": "subpackage_tiers",
"type": "folder"
},
"items": [
{
"info": {
"name": "List tiers OAuth Scope: tiers:read",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.beehiiv.com/v2/publications/:publicationId/tiers",
"headers": [
{
"name": "Authorization",
"value": ""
}
],
"params": [
{
"name": "publicationId",
"value": "",
"type": "path",
"description": "The prefixed ID of the publication object"
},
{
"name": "expand[]",
"value": "",
"type": "query",
"description": "Optional list of expandable objects.
`stats` - Returns statistics about the tier(s).
`prices` - Returns prices for the tier(s)."
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "A limit on the number of objects to be returned. The limit can range between 1 and 100, and the default is 10."
},
{
"name": "page",
"value": "",
"type": "query",
"description": "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."
},
{
"name": "direction",
"value": "",
"type": "query",
"description": "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."
}
]
},
"docs": "Retrieve all tiers belonging to a specific publication"
},
{
"info": {
"name": "Create a tier OAuth Scope: tiers:write",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.beehiiv.com/v2/publications/:publicationId/tiers",
"headers": [
{
"name": "Authorization",
"value": ""
}
],
"params": [
{
"name": "publicationId",
"value": "",
"type": "path",
"description": "The prefixed ID of the publication object"
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Create a new tier for a publication."
},
{
"info": {
"name": "Get tier OAuth Scope: tiers:read",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.beehiiv.com/v2/publications/:publicationId/tiers/:tierId",
"headers": [
{
"name": "Authorization",
"value": ""
}
],
"params": [
{
"name": "publicationId",
"value": "",
"type": "path",
"description": "The prefixed ID of the publication object"
},
{
"name": "tierId",
"value": "",
"type": "path",
"description": "The prefixed ID of the tier object"
},
{
"name": "expand[]",
"value": "",
"type": "query",
"description": "Optional list of expandable objects.
`stats` - Returns statistics about the tier(s).
`prices` - Returns prices for the tier(s)."
}
]
},
"docs": "Retrieve a single tier belonging to a specific publication"
},
{
"info": {
"name": "Update a tier OAuth Scope: tiers:write",
"type": "http"
},
"http": {
"method": "PUT",
"url": "https://api.beehiiv.com/v2/publications/:publicationId/tiers/:tierId",
"headers": [
{
"name": "Authorization",
"value": ""
}
],
"params": [
{
"name": "publicationId",
"value": "",
"type": "path",
"description": "The prefixed ID of the publication object"
},
{
"name": "tierId",
"value": "",
"type": "path",
"description": "The prefixed ID of the tier object"
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Update an existing tier belonging to a specific publication"
},
{
"info": {
"name": "Update a tier OAuth Scope: tiers:write",
"type": "http"
},
"http": {
"method": "PATCH",
"url": "https://api.beehiiv.com/v2/publications/:publicationId/tiers/:tierId",
"headers": [
{
"name": "Authorization",
"value": ""
}
],
"params": [
{
"name": "publicationId",
"value": "",
"type": "path",
"description": "The prefixed ID of the publication object"
},
{
"name": "tierId",
"value": "",
"type": "path",
"description": "The prefixed ID of the tier object"
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Update an existing tier belonging to a specific publication"
}
]
}
],
"bundled": true
}