Parties - Dollr Developer Docs

Parties are contact records — name, phone, optional email and country — for anyone you collect from or pay out to. Try in API Reference: Create · List · Retrieve

When to use

Document-first flows: create a party before a counterparty and invoice/order.
Payouts: identify the recipient before registering a payment account.

Skip manual party creation when using Hosted checkout or Collect via checkout — Dollr can match or create the payer from checkout fields.

Create

curl -X POST "https://api.heydollr.app/v1/parties/create" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fullname": "Amara Kamara",
    "phone": "231771234567",
    "email": "amara@example.com",
    "country_code": "LR"
  }'

Phone numbers use E.164 without the leading +. See API conventions.

List

curl "https://api.heydollr.app/v1/parties/list?fullname=Amara" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Retrieve

curl "https://api.heydollr.app/v1/parties/retrieve/42" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Last modified on June 23, 2026