# Renew Domains

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v2/domains/renew:
    post:
      summary: Renew Domains
      deprecated: false
      description: >-
        Use this endpoint to initiate renewal for domains expiring within the
        next 2 months. Available wallet balance is automatically applied to
        reduce the invoice amount.


        Note: High-reputation domains and pre-warmed domains are not eligible
        for renewal through this endpoint.
      tags:
        - domains
      parameters:
        - name: x-auth-zapmail
          in: header
          description: ''
          required: true
          example: YOUR_API_KEY
          schema:
            type: string
        - name: x-workspace-key
          in: header
          description: ''
          required: false
          example: workspace_id
          schema:
            type: string
        - name: x-service-provider
          in: header
          description: ''
          required: false
          example: GOOGLE
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                domainIds:
                  type: array
                  items:
                    type: string
                  description: |
                    List of domain IDs to renew
                contains:
                  type: string
                  description: |
                    Filter domains by name substring
                tagIds:
                  type: array
                  items:
                    type: string
                  description: |
                    Filter by tag IDs
              x-apidog-orders:
                - domainIds
                - contains
                - tagIds
            examples: {}
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      paymentLink:
                        type: string
                      domains:
                        type: array
                        items:
                          type: string
                      domainIds:
                        type: array
                        items:
                          type: string
                      useWallet:
                        type: boolean
                    required:
                      - paymentLink
                      - domains
                      - domainIds
                      - useWallet
                    x-apidog-orders:
                      - paymentLink
                      - domains
                      - domainIds
                      - useWallet
                required:
                  - status
                  - message
                  - data
                x-apidog-orders:
                  - status
                  - message
                  - data
              example:
                status: 200
                message: Domain Renewal payment link generated successfully
                data:
                  paymentLink: https://invoice.stripe.com/i/acct_xxx/live_xxx
                  domains:
                    - bulk-cart-order-uuid
                  domainIds:
                    - domain-uuid-1
                    - domain-uuid-2
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: domains
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/797058/apis/api-33617150-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.zapmail.ai/api
    description: Prod Env
security: []

```