{ "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 }