Mail: Orders
List orders
Retrieve a paginated list of mail orders associated with your account.
Use this endpoint to monitor your mail services, including their status, plan, attached domain, and expiration details.
get/api/mail/v1/orders
Query parameters
domainstring nullable
Example:example.com
Filter orders by domain name (exact match)
status'pending_setup' | 'active' | 'suspended' nullable
Example:active
Filter orders by status
is_trialboolean nullable
Filter orders by trial state
sort'created_at' | '-created_at' | 'expires_at' | '-expires_at' nullable
Example:-created_at
Sort orders by field. Prefix with - for descending order.
pageinteger
Example:1
Page number
per_pageinteger
Example:25
Number of items per page
Response
Success response
Example response
{
"data": [
{
"id": "OR1a2b3c4d5e6f7g",
"status": "active",
"seats": 5,
"domain": {
"id": "DO1a2b3c4d5e6f7g",
"name": "example.com"
},
"plan": {
"name": "hostinger_free",
"title": "Free Email"
},
"created_at": "2025-02-27T11:54:22Z",
"expires_at": "2026-02-27T11:54:22Z"
}
],
"meta": {
"current_page": 1,
"per_page": 15,
"total": 100
}
}