---
title: "Get a domain order"
method: GET
path: "/v1/registrar/orders/{orderId}"
tags: ["domains-registrar"]
---

# Get a domain order

`GET /v1/registrar/orders/{orderId}`

Get information about a domain order by its ID

## Path parameters

- `orderId` string, required — A valid order ID

## Query parameters

- `teamId` string

## Response `200`

Success

- object
  - `orderId` string, required — A valid order ID
  - `domains` union[], required
    - union
      - object
        - `purchaseType` 'purchase', required
        - `autoRenew` boolean, required
        - `years` number, required — The number of years the domain is being purchased for.
        - `domainName` string, required — A valid domain name
        - `status` 'pending' | 'completed' | 'failed' | 'refunded' | 'refund-failed', required
        - `price` number, required
        - `error` union
          - object
            - `code` 'unsupported-language-code', required
            - `details` object, required
              - …
          - object
            - `code` 'incorrect-language-code', required
            - `details` object, required
              - …
          - object
            - `code` 'client-transfer-prohibited', required
          - object
            - `code` 'incorrect-auth-code', required
          - object
            - `code` 'claims-notice-required', required
          - object
            - `code` 'cannot-transfer-in-until', required
            - `details` object, required
              - …
          - object
            - `code` 'account-transfer-required', required
          - object
            - `code` 'price-change', required
          - object
            - `code` 'unavailable-legal', required
          - object
            - `code` 'invalid-contact', required
            - `details` object, required
              - …
          - object
            - `code` string, required
            - `details` unknown
      - object
        - `purchaseType` 'renewal', required
        - `years` number, required — The number of years the domain is being renewed for.
        - `domainName` string, required — A valid domain name
        - `status` 'pending' | 'completed' | 'failed' | 'refunded' | 'refund-failed', required
        - `price` number, required
        - `error` union
          - object
            - `code` 'unsupported-language-code', required
            - `details` object, required
              - …
          - object
            - `code` 'incorrect-language-code', required
            - `details` object, required
              - …
          - object
            - `code` 'client-transfer-prohibited', required
          - object
            - `code` 'incorrect-auth-code', required
          - object
            - `code` 'claims-notice-required', required
          - object
            - `code` 'cannot-transfer-in-until', required
            - `details` object, required
              - …
          - object
            - `code` 'account-transfer-required', required
          - object
            - `code` 'price-change', required
          - object
            - `code` 'unavailable-legal', required
          - object
            - `code` 'invalid-contact', required
            - `details` object, required
              - …
          - object
            - `code` string, required
            - `details` unknown
      - object
        - `purchaseType` 'transfer', required
        - `autoRenew` boolean, required
        - `years` number, required — The number of years the domain is being transferred for.
        - `domainName` string, required — A valid domain name
        - `status` 'pending' | 'completed' | 'failed' | 'refunded' | 'refund-failed', required
        - `price` number, required
        - `error` union
          - object
            - `code` 'unsupported-language-code', required
            - `details` object, required
              - …
          - object
            - `code` 'incorrect-language-code', required
            - `details` object, required
              - …
          - object
            - `code` 'client-transfer-prohibited', required
          - object
            - `code` 'incorrect-auth-code', required
          - object
            - `code` 'claims-notice-required', required
          - object
            - `code` 'cannot-transfer-in-until', required
            - `details` object, required
              - …
          - object
            - `code` 'account-transfer-required', required
          - object
            - `code` 'price-change', required
          - object
            - `code` 'unavailable-legal', required
          - object
            - `code` 'invalid-contact', required
            - `details` object, required
              - …
          - object
            - `code` string, required
            - `details` unknown
  - `status` 'draft' | 'purchasing' | 'completed' | 'failed', required
  - `error` union
    - object
      - `code` 'payment-failed', required
    - object
      - `code` 'tld-outage', required
      - `details` object, required
        - `tlds` object[], required
          - `tldName` string, required
          - `endsAt` string, required
    - object
      - `code` 'price-mismatch', required
      - `details` object, required
        - `expectedPrice` number, required
        - `actualPrice` number
    - object
      - `code` 'unexpected-error', required
    - object
      - `code` 'claims-required', required
      - `details` object, required
        - `message` string, required
        - `domainNames` string[], required
    - object
      - `code` 'domain-mismatch', required
    - object
      - `code` string, required
      - `details` unknown

## Other responses

- `400` — There was something wrong with the request
- `401` — Unauthorized
- `403` — NotAuthorizedForScope
- `404` — NotFound
- `429` — TooManyRequests
- `500` — InternalServerError

---

[API](https://skmtc.net/vercel/apis/api.md) · [All operations](https://skmtc.net/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/api/versions/61d1ba3f6dac/schema)