Skip to main content
GET
/
api
/
v1
/
domains
/
orders
List domain orders
curl --request GET \
  --url https://dev.namify.host/api/v1/domains/orders \
  --header 'Authorization: Bearer <token>'
{
  "total_orders": 2,
  "orders_on_page": 2,
  "orders": [
    {
      "order_id": 124680932,
      "domain_name": "example.com",
      "status": "Active",
      "expiry": "Mar 8, 2028",
      "expiry_timestamp": 1835699117
    },
    {
      "order_id": 124680901,
      "domain_name": "myshop.com",
      "status": "Expired",
      "expiry": "Jan 1, 2025",
      "expiry_timestamp": 1735689600
    }
  ]
}

Authorizations

Authorization
string
header
required

A personal access token. Obtain one from the dashboard under Settings > API Key. Include it in the Authorization header as Bearer <token>. Unauthenticated requests to protected routes return 401 Unauthorized.

Query Parameters

customer_id
integer
required

ID of the customer whose domain orders to retrieve.

Example:

85384231

page
integer
default:1

Page number for pagination. Defaults to 1.

Example:

1

Optional keyword to filter orders by domain name.

Example:

"example"

Response

Domain orders retrieved successfully.

total_orders
integer

Total number of orders matching the query across all pages.

Example:

42

orders_on_page
integer

Number of orders returned on the current page.

Example:

10

orders
object[]