# Get Prewarm Subscriptions

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v2/prewarmed-domains/subscriptions:
    get:
      summary: Get Prewarm Subscriptions
      deprecated: false
      description: >-
        Returns a paginated list of the authenticated user's pre-warmed mailbox
        subscriptions, including base plans and add-ons.
      tags:
        - prewarmed domains
      parameters:
        - name: status
          in: query
          description: ''
          required: false
          example: ACTIVE
          schema:
            type: string
        - name: page
          in: query
          description: ''
          required: false
          example: '1'
          schema:
            type: string
        - name: limit
          in: query
          description: ''
          required: false
          example: '10'
          schema:
            type: string
        - name: x-auth-zapmail
          in: header
          description: ''
          required: true
          example: a9ef882f-9a1e-4fc1-9a59-f2f3bc2fdf57
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      subscriptions:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            subscriptionId:
                              type: string
                            subscriptionStatus:
                              type: string
                            plan:
                              type: string
                            price:
                              type: integer
                            totalMailboxQuantity:
                              type: integer
                            periodStart:
                              type: string
                            periodEnd:
                              type: string
                            subscriptionCreationDate:
                              type: string
                            paymentFailureMessage:
                              type: 'null'
                            billingCycle:
                              type: string
                            serviceProvider:
                              type: string
                            domains:
                              type: array
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                  domain:
                                    type: string
                                required:
                                  - id
                                  - domain
                                x-apidog-orders:
                                  - id
                                  - domain
                            mailboxes:
                              type: array
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                  username:
                                    type: string
                                  domain:
                                    type: string
                                  firstName:
                                    type: string
                                  lastName:
                                    type: string
                                  status:
                                    type: string
                                  createdAt:
                                    type: string
                                required:
                                  - id
                                  - username
                                  - domain
                                  - firstName
                                  - lastName
                                  - status
                                  - createdAt
                                x-apidog-orders:
                                  - id
                                  - username
                                  - domain
                                  - firstName
                                  - lastName
                                  - status
                                  - createdAt
                            invoiceDetails:
                              type: string
                          x-apidog-orders:
                            - id
                            - subscriptionId
                            - subscriptionStatus
                            - plan
                            - price
                            - totalMailboxQuantity
                            - periodStart
                            - periodEnd
                            - subscriptionCreationDate
                            - paymentFailureMessage
                            - billingCycle
                            - serviceProvider
                            - domains
                            - mailboxes
                            - invoiceDetails
                      total:
                        type: integer
                      currentPage:
                        type: integer
                      nextPage:
                        type: integer
                      totalPages:
                        type: integer
                    required:
                      - subscriptions
                      - total
                      - currentPage
                      - nextPage
                      - totalPages
                    x-apidog-orders:
                      - subscriptions
                      - total
                      - currentPage
                      - nextPage
                      - totalPages
                required:
                  - status
                  - message
                  - data
                x-apidog-orders:
                  - status
                  - message
                  - data
              example:
                status: 200
                message: Pre-warmed up subscriptions fetched
                data:
                  subscriptions:
                    - id: c2268925-57-44c3-a7b5-be1d98bc1694
                      subscriptionId: sub_1TAlLWPCpCE65rMoxGxme6
                      subscriptionStatus: ACTIVE
                      plan: Pro
                      uniquePlanKey: prewarmed_up_pro_monthly_microsoft
                      price: 180
                      totalMailboxQuantity: 30
                      periodStart: '2026-04-14T00:36:46.000Z'
                      periodEnd: '2026-05-14T00:36:46.000Z'
                      subscriptionCreationDate: '2026-03-14T00:36:46.000Z'
                      paymentFailureMessage: null
                      billingCycle: MONTHLY
                      serviceProvider: GOOGLE
                      domains:
                        - id: 923b513f-9d13-407d-998b-efb7096c64bf
                          domain: yourcompanynow.info
                      invoiceDetails: https://invoice.stripe.com/...
                  total: 23
                  currentPage: 1
                  nextPage: 2
                  totalPages: 1
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: prewarmed domains
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/797058/apis/api-33586054-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.zapmail.ai/api
    description: Prod Env
security: []

```