---
title: "List Domain Purchases"
method: GET
path: "/v1/domains/purchase/registrations"
tags: ["Domains"]
---

# List Domain Purchases

`GET /v1/domains/purchase/registrations`

## Request

- Base URL: `https://api.migma.ai`
- URL: `https://api.migma.ai/v1/domains/purchase/registrations`
- Auth: API key in header `Authorization`

List domain purchases and their registration status. Status moves from payment_pending to registering to active, or to failed or refunded. Requires API key with domain:read permission.

## Query parameters

- `limit` integer

## Response `200`

Domain purchase registrations

- ApiResponseDomainPurchaseRegistrations
  - `success` boolean, required
  - `data` object, nullable
    - `registrations` DomainPurchaseRegistration[], required
      - `id` string, required: Registration id
      - `rootDomain` string, required: The purchased domain
      - `status` 'payment_pending' | 'registering' | 'active' | 'failed' | 'refunded', required: Registration status. Moves from payment_pending to registering to active. Failed registrations are refunded.
      - `sellPrice` number: Yearly registration price paid
      - `currency` string: Currency for sellPrice, e.g. 'USD'
  - `error` string, nullable

## Other responses

- `401`: Unauthorized
- `403`: Forbidden - Missing required permissions or access denied

## Changes

- **2026-08-22** `2d06ad0e0bc3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/migma/apis/migma-ai-api-v1/changes/v1/domains/purchase/registrations/get.md)

---

[API](https://skmtc.dev/migma/apis/migma-ai-api-v1.md) - [All operations](https://skmtc.dev/migma/apis/migma-ai-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/migma/apis/migma-ai-api-v1/revisions/2ce0e1e4d856?raw)