> ## Documentation Index > Fetch the complete documentation index at: https://docs.notifuse.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a blog post > Retrieves a post by `id` or by `slug`; when both are given, `id` wins. Drafts are returned too. Requires the blog read permission. ## OpenAPI ````yaml /openapi.json get /api/blogPosts.get openapi: 3.0.3 info: title: Notifuse API description: API for Notifuse - a transactional email and newsletter management platform version: 1.0.0 contact: name: Notifuse Support url: https://www.notifuse.com/support email: hello@notifuse.com license: name: BUSL-1.1 url: https://github.com/Notifuse/notifuse/blob/main/LICENSE servers: - url: https://{notifuseDomain} description: Customer-specific Notifuse API server variables: notifuseDomain: description: Your unique Notifuse domain default: demo.notifuse.com security: [] paths: /api/blogPosts.get: get: tags: - Blog summary: Get a blog post description: >- Retrieves a post by `id` or by `slug`; when both are given, `id` wins. Drafts are returned too. Requires the blog read permission. operationId: getBlogPost parameters: - name: workspace_id in: query required: true schema: type: string description: The ID of the workspace example: ws_1234567890 - name: id in: query required: false schema: type: string description: The post ID. Either `id` or `slug` is required. example: 1b4e28ba-2fa1-11d2-883f-0016d3cca427 - name: slug in: query required: false schema: type: string description: >- The post slug. Either `id` or `slug` is required. Post slugs are unique across the workspace, so the slug alone identifies the post. example: october-release - name: category_slug in: query required: false schema: type: string description: >- With `slug`, only match the post if it is in this category — the lookup a `/{category_slug}/{post_slug}` URL maps to. example: product responses: '200': description: The post content: application/json: schema: $ref: '#/components/schemas/BlogPostResponse' '400': description: Bad request - missing query parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: either id or slug is required '401': description: Unauthorized - invalid or missing authentication token content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden - missing the blog read permission content: application/json: schema: $ref: '#/components/schemas/PermissionErrorResponse' example: error: 'Insufficient permissions: read access to blog required' resource: blog permission: read '500': description: Internal server error. Also returned when no post matches. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Failed to get post security: - BearerAuth: [] components: schemas: BlogPostResponse: type: object required: - post properties: post: $ref: '#/components/schemas/BlogPost' ErrorResponse: type: object properties: error: type: string description: Error message required: - error PermissionErrorResponse: type: object description: >- Returned with a 403 when the user or API key lacks the permission the endpoint requires. properties: error: type: string description: Error message resource: type: string description: The permission resource the endpoint requires. example: blog permission: type: string enum: - read - write description: The access level the endpoint requires on that resource. required: - error - resource - permission BlogPost: type: object required: - id - category_id - slug - settings - created_at - updated_at properties: id: type: string description: Server-generated UUID. example: 1b4e28ba-2fa1-11d2-883f-0016d3cca427 category_id: type: string example: 7c9e6679-7425-40de-944b-e07fc1f90ae7 slug: type: string description: >- The post's path segment on the blog (`/{category_slug}/{post_slug}`). example: october-release settings: type: object required: - title - template - reading_time_minutes properties: title: type: string description: The post's H1. example: What shipped in October template: type: object required: - template_id - template_version description: The web template holding the post body. properties: template_id: type: string example: blog_october_release template_version: type: integer description: >- The template version the post renders. `0` means the latest version, whatever it is at render time. example: 3 excerpt: type: string example: A faster editor, scheduled broadcasts and a new API. featured_image_url: type: string example: https://cdn.example.com/blog/october.png authors: type: array nullable: true items: $ref: '#/components/schemas/BlogAuthor' reading_time_minutes: type: integer description: Displayed as given; not computed from the body. example: 4 seo: $ref: '#/components/schemas/SEOSettings' published_at: type: string format: date-time description: Absent while the post is a draft. example: '2026-10-01T09:00:00Z' created_at: type: string format: date-time updated_at: type: string format: date-time BlogAuthor: type: object required: - name properties: name: type: string example: Jane Doe avatar_url: type: string example: https://cdn.example.com/avatars/jane.png SEOSettings: type: object description: Search and social metadata for the page, exposed to the blog theme. properties: meta_title: type: string example: Release notes for October meta_description: type: string example: Everything that shipped this month. og_title: type: string description: Open Graph title og_description: type: string description: Open Graph description og_image: type: string description: Open Graph image URL example: https://cdn.example.com/og/october.png canonical_url: type: string example: https://blog.example.com/product/october-release keywords: type: array items: type: string example: - release - changelog meta_robots: type: string description: Content of the robots meta tag. example: index,follow securitySchemes: BearerAuth: type: http scheme: bearer description: API token for authentication ````