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

# List Domain Purchases

`GET /v1/domains/purchase/registrations`

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

---

[API](https://skmtc.net/migma/apis/migma-ai-api-v1.md) · [All operations](https://skmtc.net/migma/apis/migma-ai-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/migma/migma-ai-api-v1/revisions/2d06ad0e0bc3/schema)