Browse documentation

GETTING STARTED

HL Hunt API

A REST API for automating debt collection: manage debtors and cases, read and send conversation messages, create payment links and installment plans, and receive a signed webhook event stream.

At a glance

Base URL: https://debt.hlhunt.org/api/v1 · API version: 2026-08-31

Requests and responses are JSON. Every monetary field ends in _cents and is a stringof integer cents — amounts can exceed JSON's safe integer range, so never parse them as floats. Errors are RFC 7807 problem+json.

Your first request

Create a test API key (it operates on your sandbox — no live debtors, providers, or messages), then:

curl https://debt.hlhunt.org/api/v1/debtors \
  -H "Authorization: Bearer hlh_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: create-avery-1" \
  -d '{"givenName": "Avery", "email": "avery@example.com"}' \
  -X POST

From there: create a case for the debtor, watch case.created arrive on your webhook endpoint, and explore each resource from the navigation.

Authentication →Debtors →OpenAPI spec