Loading…
Three endpoints let you reconcile what you owe name.ai (MoR sales) and what name.ai owes you (name.ai-collected sales and brokerage commissions).
TRANSFER_COMPLETED.amount_owed_cents.GET /payouts.Per-period settlement statements. Each record shows what you sold, your commission, and the amount owed to name.ai.
| Parameter | Description |
|---|---|
| from / to | ISO-8601 date range filter (inclusive). |
| status | Filter by: pending | due | paid. |
| cursor | Cursor from previous page for pagination. |
{
"settlements": [
{
"period_start": "2026-06-01",
"period_end": "2026-06-15",
"status": "pending",
"orders_count": 3,
"gross_sold_cents": 5200000,
"partner_commission_cents": 780000,
"amount_owed_cents": 4420000,
"due_date": "2026-07-15",
"currency": "USD"
}
]
}Full sales history — every domain sold through your channel — with totals (GMV, commission).
| Parameter | Description |
|---|---|
| from / to | ISO-8601 date range. |
| status | Filter by order status (EXTERNALLY_PAID, TRANSFER_COMPLETED, SETTLED, …). |
| payment_model | partner_collected or name_ai_collected. |
| cursor | Pagination cursor. |
{
"totals": {
"gmv_cents": 5200000,
"partner_commission_cents": 780000,
"count": 3,
"currency": "USD"
},
"transactions": [
{
"public_id": "ord_01JABC...",
"domain": "custodylawyer.com",
"status": "TRANSFER_COMPLETED",
"sale_price_cents": 2500000,
"partner_commission_cents": 375000,
"payment_model": "partner_collected",
"created_at": "2026-06-08T07:00:00Z"
}
],
"next_cursor": null
}Payout history — amounts name.ai has paid to you (name.ai-collected sales, brokerage commissions).
{
"total_paid_cents": 125000,
"currency": "USD",
"payouts": [
{
"id": "pay_01JX...",
"amount_cents": 62500,
"currency": "USD",
"paid_at": "2026-06-01T00:00:00Z",
"method": "bank_transfer",
"reference": "NMAI-2026-06-01-001"
}
]
}Request a refund or clawback for a partner-collected order. The order must not yet be TRANSFER_COMPLETED. Triggers a manual review by name.ai ops.
POST /api/partner/v1/refunds
Content-Type: application/json
Idempotency-Key: ref_<uuid>
...auth headers...
{
"order_id": "ord_01JABC...",
"reason": "buyer_requested"
}Next: Webhooks & events →