Settlement & reconciliation

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).

Settlement schedule

Maturity period: 45 days from order TRANSFER_COMPLETED.
Payout runs: 1st and 15th of each month. Orders that matured since the last run are included.
MoR partners (you owe us): You remit name.ai's share (gross sale − your commission) within the settlement period. The amount owed is in amount_owed_cents.
Non-MoR / name.ai-collected: Name.ai pays you your commission. Amount in GET /payouts.

GET

/api/partner/v1/settlements

scope: buy

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.

Response 200

{
  "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"
    }
  ]
}

GET

/api/partner/v1/transactions

scope: report

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.

Response 200

{
  "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
}

GET

/api/partner/v1/payouts

scope: report

Payout history — amounts name.ai has paid to you (name.ai-collected sales, brokerage commissions).

Response 200

{
  "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"
    }
  ]
}

POST

/api/partner/v1/refunds

scope: buy

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.

Request

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 →