Settlements

Settlements represent batched payouts of your processed transactions to your bank account. The processor groups transactions, deducts fees, and deposits the net amount.

GET
/api/settlements

List Settlements

Returns all settlements for your account. Use ?status= to filter by PENDING, APPROVED, FUNDING, FUNDED, COMPLETE, or CANCELED.

curl -X GET "https://api.hlhunt.org/v1/../settlements?status=FUNDED&limit=50" \
  -H "Authorization: Bearer sk_live_your_api_key"
GET
/api/settlements/{settlement_id}

Fetch a Settlement

Retrieve a single settlement by ID with its summary breakdown.

curl -X GET /api/settlements/STxxxxxxxxxxxxxxxxxx \
  -H "Authorization: Bearer sk_live_your_api_key"
GET
/api/settlements/{settlement_id}/entries

List Settlement Entries

Returns all individual entries (transfers, fees, adjustments) within a settlement.

curl -X GET /api/settlements/STxxxxxxxxxxxxxxxxxx/entries \
  -H "Authorization: Bearer sk_live_your_api_key"
GET
/api/settlements/{settlement_id}/funding-transfers

List Funding Transfers

Returns the funding transfer(s) associated with a settlement.

curl -X GET /api/settlements/STxxxxxxxxxxxxxxxxxx/funding-transfers \
  -H "Authorization: Bearer sk_live_your_api_key"