# Get domain connection requests

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v2/domains/connection-requests:
    get:
      summary: Get domain connection requests
      deprecated: false
      description: >-
        This endpoint allows you to retrieve a list of domains that are still in
        progress and pending connection with Zapmail.
      tags:
        - domains
      parameters:
        - 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: status
          in: query
          description: ''
          required: false
          schema:
            type: string
            enum:
              - PENDING
              - CHECKING_IF_DOMAIN_IS_REGISTERED
              - DOMAIN_NOT_REGISTERED
              - DOMAIN_ALREADY_REGISTERED
              - CHECKING_EXISTING_WORKSPACE_STATUS
              - WORKSPACE_ALREADY_EXISTS
              - CHECKING_NS_IN_WHOIS
              - NS_NOT_CHANGED
              - CREATING_ZONE
              - SUCCESS
              - FAILED
              - CHECKING_CLOUDFLARE_PERMISSIONS
              - PERMISSION_REQUIRED
              - ENABLE_DNS_SHIELD
            x-apidog-enum:
              - value: PENDING
                name: PENDING
                description: ''
              - value: CHECKING_IF_DOMAIN_IS_REGISTERED
                name: CHECKING_IF_DOMAIN_IS_REGISTERED
                description: ''
              - value: DOMAIN_NOT_REGISTERED
                name: DOMAIN_NOT_REGISTERED
                description: ''
              - value: DOMAIN_ALREADY_REGISTERED
                name: DOMAIN_ALREADY_REGISTERED
                description: ''
              - value: CHECKING_EXISTING_WORKSPACE_STATUS
                name: CHECKING_EXISTING_WORKSPACE_STATUS
                description: ''
              - value: WORKSPACE_ALREADY_EXISTS
                name: WORKSPACE_ALREADY_EXISTS
                description: ''
              - value: CHECKING_NS_IN_WHOIS
                name: CHECKING_NS_IN_WHOIS
                description: ''
              - value: NS_NOT_CHANGED
                name: NS_NOT_CHANGED
                description: ''
              - value: CREATING_ZONE
                name: CREATING_ZONE
                description: ''
              - value: SUCCESS
                name: SUCCESS
                description: ''
              - value: FAILED
                name: FAILED
                description: ''
              - value: CHECKING_CLOUDFLARE_PERMISSIONS
                name: CHECKING_CLOUDFLARE_PERMISSIONS
                description: ''
              - value: PERMISSION_REQUIRED
                name: PERMISSION_REQUIRED
                description: ''
              - value: ENABLE_DNS_SHIELD
                name: ENABLE_DNS_SHIELD
                description: ''
        - name: contains
          in: query
          description: >-
            Search filter for the target domains which has the specified
            substring.
          required: false
          example: zapdns
          schema:
            type: string
        - name: cloudflareCredentialsId
          in: query
          description: Cloudflare credential id associated to the domain
          required: false
          schema:
            type: string
        - name: x-auth-zapmail
          in: header
          description: ''
          required: true
          example: ''
          schema:
            type: string
        - name: x-workspace-key
          in: header
          description: ''
          required: false
          example: ''
          schema:
            type: string
        - name: x-service-provider
          in: header
          description: ''
          required: false
          example: ''
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      totalSearchedCount:
                        type: integer
                      currentPage:
                        type: integer
                      nextPage:
                        type: integer
                      totalPages:
                        type: integer
                      totalCount:
                        type: integer
                      data:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            domainName:
                              type: string
                            userId:
                              type: string
                            workspaceId:
                              type: string
                            serviceProvider:
                              type: string
                            dnsManagedBy:
                              type: string
                            status:
                              type: string
                            metadata:
                              type: object
                              properties:
                                currentNameServers:
                                  type: array
                                  items:
                                    type: string
                              required:
                                - currentNameServers
                              x-apidog-orders:
                                - currentNameServers
                            nextRetryOn:
                              type: string
                            createdAt:
                              type: string
                            updatedAt:
                              type: string
                            deletedAt:
                              type: 'null'
                          x-apidog-orders:
                            - id
                            - domainName
                            - userId
                            - workspaceId
                            - serviceProvider
                            - dnsManagedBy
                            - status
                            - metadata
                            - nextRetryOn
                            - createdAt
                            - updatedAt
                            - deletedAt
                    required:
                      - totalSearchedCount
                      - currentPage
                      - nextPage
                      - totalPages
                      - totalCount
                      - data
                    x-apidog-orders:
                      - totalSearchedCount
                      - currentPage
                      - nextPage
                      - totalPages
                      - totalCount
                      - data
                required:
                  - status
                  - message
                  - data
                x-apidog-orders:
                  - status
                  - message
                  - data
          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-18247843-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.zapmail.ai/api
    description: Prod Env
security: []

```