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

# Bulk transfer domains in

> Initiate transfer-in for up to 10 domains in a single request. All domains are validated and priced first; a single payment is charged for the aggregate total. Transfers are then initiated one by one. Domains that fail to transfer are individually refunded to your account balance (if paid via balance) or flagged for manual review (if paid via card).



## OpenAPI

````yaml POST /registrar/v1/domains/transfer-bulk
openapi: 3.0.0
info:
  title: Atom Registrar API
  version: 1.0.0
  description: >-
    REST API for domain registration, DNS management, and domain operations.
    Authentication via Bearer token in Authorization header.
servers:
  - url: https://www.atom.com/api
    description: Production server
  - url: https://dev.atom.com/api
    description: Development server
security:
  - BearerAuth: []
paths:
  /registrar/v1/domains/transfer-bulk:
    post:
      tags:
        - Registrar
      summary: Bulk transfer domains in
      description: >-
        Initiate transfer-in for up to 10 domains in a single request. All
        domains are validated and priced first; a single payment is charged for
        the aggregate total. Transfers are then initiated one by one. Domains
        that fail to transfer are individually refunded to your account balance
        (if paid via balance) or flagged for manual review (if paid via card).
      operationId: transferDomainBulk
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DomainBulkTransferRequest'
      responses:
        '201':
          description: Bulk transfer complete (may include partial failures)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DomainBulkTransferResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '402':
          description: Payment failed for the full batch
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: No domains passed validation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    DomainBulkTransferRequest:
      type: object
      required:
        - domains
      properties:
        domains:
          type: array
          maxItems: 10
          description: List of domains to transfer (max 10 per request)
          items:
            type: object
            required:
              - domain_name
              - authcode
            properties:
              domain_name:
                type: string
                example: example.com
              authcode:
                type: string
                example: Ab1!Cd2@Ef3#
    DomainBulkTransferResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        message:
          type: string
          example: 'Bulk transfer complete: 2 initiated, 0 failed'
        data:
          type: object
          properties:
            cart_id:
              type: integer
              example: 12345
            payment_method:
              type: string
              enum:
                - account_balance
                - saved_card
              example: account_balance
            total_requested:
              type: integer
              example: 2
            total_valid:
              type: integer
              example: 2
            succeeded:
              type: integer
              example: 2
            failed:
              type: integer
              example: 0
            total_charged:
              type: number
              format: float
              example: 20.34
            total_refunded:
              type: number
              format: float
              example: 0
              description: >-
                Amount refunded to account balance for failed transfers (only
                when payment method is account_balance)
            results:
              type: array
              items:
                type: object
                properties:
                  domain:
                    type: string
                    example: example.com
                  status:
                    type: string
                    enum:
                      - Transfer Initiated
                      - failed
                    example: Transfer Initiated
                  error:
                    type: string
                    description: Present only when status is failed
                    example: Domain is locked for transfer
                  price_breakdown:
                    type: object
                    description: Present only when status is Transfer Initiated
                    properties:
                      unit_price:
                        type: number
                        format: float
                        example: 9.99
                      icann_fee:
                        type: number
                        format: float
                        example: 0.18
                      is_premium:
                        type: boolean
                        example: false
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        error:
          type: string
          example: Bad Request
        message:
          type: string
          example: Invalid input provided
  responses:
    BadRequest:
      description: Bad request - invalid parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    UnauthorizedError:
      description: Authentication failed - invalid or revoked API token
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                example: false
              error:
                type: string
                example: Unauthorized
              message:
                type: string
                example: >-
                  Invalid registrar API token or access has been revoked. Please
                  request registrar API access from your dashboard.
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        Registrar API Bearer token. Obtain from dashboard at
        /dashboard/seller/api-access after requesting Registrar API access.

````