Skip to main content
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