> ## Documentation Index
> Fetch the complete documentation index at: https://blogbowl.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List all emails for a newsletter



## OpenAPI

````yaml https://app.blogbowl.io/api/v1/misc/openapi.json get /newsletters/{newsletter_id}/emails
openapi: 3.0.0
info:
  title: BlogBowl API
  description: >-
    REST API for managing blog pages, posts, authors, newsletters, and
    subscribers.
  version: 1.0.0
  x-copyright: null
servers:
  - url: https://app.blogbowl.io/api/v1
security: []
tags:
  - name: Authors
  - name: Categories
  - name: Emails
  - name: Images
  - name: Newsletters
  - name: Pages
  - name: Posts
  - name: Subscribers
paths:
  /newsletters/{newsletter_id}/emails:
    get:
      tags:
        - Emails
      summary: List all emails for a newsletter
      operationId: get_newsletters_newsletter_id_emails
      parameters:
        - name: newsletter_id
          in: path
          required: true
          description: Newsletter ID
          schema:
            type: number
        - name: status
          in: query
          description: Filter by status (draft, scheduled, sent, failed)
          schema:
            type: string
            default: null
        - name: page
          in: query
          description: Page number
          schema:
            type: number
            default: 1
        - name: size
          in: query
          description: 'Items per page (max: 100)'
          schema:
            type: number
            default: 10
      responses:
        '200':
          description: Paginated list of emails
          headers: {}

````