Get post OAuth Scope: posts:read

GET

https://api.beehiiv.com/v2/publications/:publicationId/posts/:postId

GET

/v2/publications/:publicationId/posts/:postId

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

1 {
2   "data": {
3     "id": "post_00000000-0000-0000-0000-000000000000",
4     "subtitle": "New post subtitle",
5     "title": "New Post Title",
6     "authors": [
7       "Clark Kent"
8     ],
9     "created": 1666800076,
10     "status": "draft",
11     "split_tested": true,
12     "subject_line": "Check this out",
13     "preview_text": "More news on the horizon",
14     "slug": "slug",
15     "thumbnail_url": "thumbnail_url",
16     "web_url": "web_url",
17     "audience": "free",
18     "platform": "web",
19     "content_tags": [
20       "content_tags"
21     ],
22     "hidden_from_feed": false,
23     "enforce_gated_content": false,
24     "email_capture_popup": false,
25     "publish_date": 1666800076,
26     "displayed_date": 1666800076,
27     "preview_url": "https://app.beehiiv.com/posts/post_00000000-0000-0000-0000-000000000000/preview",
28     "meta_default_description": "A post with great content",
29     "meta_default_title": "My great post",
30     "newsletter_list_id": "nl_list_00000000-0000-0000-0000-000000000000",
31     "content": {
32       "free": {
33         "web": "<HTML><body><h1>New Post</h1></body></HTML>",
34         "email": "<HTML><body><h1>New Post</h1></body></HTML>",
35         "rss": "<HTML><body><h1>New Post</h1></body></HTML>"
36       },
37       "premium": {
38         "web": "<HTML><body><h1>New Post</h1></body></HTML>",
39         "email": "<HTML><body><h1>New Post</h1></body></HTML>"
40       }
41     },
42     "stats": {
43       "email": {
44         "recipients": 100,
45         "delivered": 100,
46         "opens": 50,
47         "unique_opens": 45,
48         "clicks": 10,
49         "unique_clicks": 8,
50         "unsubscribes": 1,
51         "spam_reports": 1
52       },
53       "web": {
54         "views": 200,
55         "clicks": 40
56       },
57       "clicks": [
58         {
59           "total_clicks": 10,
60           "total_unique_clicks": 8,
61           "total_click_through_rate": 30
62         }
63       ]
64     }
65   }
66 }

Retrieve a single Post belonging to a specific publication.

Posts created via the Send API are built asynchronously, so a recently created post may not exist yet. When the post is still being created, this endpoint returns 202 (still being created) with a Retry-After header — wait briefly and retry. If background creation failed, it returns 404 with the error code POST_CREATION_FAILED, indicating the post will never become available; verify your request and try creating it again.

Retrieve a single Post belonging to a specific publication. Posts created via the Send API are built asynchronously, so a recently created post may not exist yet. When the post is still being created, this endpoint returns `202` (still being created) with a `Retry-After` header — wait briefly and retry. If background creation failed, it returns `404` with the error code `POST_CREATION_FAILED`, indicating the post will never become available; verify your request and try creating it again.

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

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

The prefixed ID of the post object

Query parameters

expandlist of enumsOptional

Optionally expand the results by adding additional information.
stats - Adds statistics about the post(s).
free_web_content - Adds the web HTML rendered to a free reader.
free_email_content - Adds the email HTML rendered to a free reader.
free_rss_content - Adds the RSS feed HTML.
premium_web_content - Adds the web HTML rendered to a premium reader.
premium_email_content - Adds the email HTML rendered to a premium reader.

Optionally expand the results by adding additional information. `stats` - Adds statistics about the post(s). `free_web_content` - Adds the web HTML rendered to a free reader. `free_email_content` - Adds the email HTML rendered to a free reader. `free_rss_content` - Adds the RSS feed HTML. `premium_web_content` - Adds the web HTML rendered to a premium reader. `premium_email_content` - Adds the email HTML rendered to a premium reader.

premium_tierslist of stringsOptional

Scope any expanded content output to the specified premium tiers.
This takes in an array of Display Names of the premium tiers.
Note: This is case insensitive.

Response

dataobject

Errors

202

Post Processing Error

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error