Browse the API30

cases

get

/api/v1/cases

The organization's underwriting cases, paginated.

Scope: cases:read
Rate limit: 200 requests / min
Idempotency: read-only

Authentication

Send your key as Authorization: Bearer …. It must carry the scope cases:read; a key without it receives 403 forbidden.

Query parameters

applicant_typestring (enum)individualbusiness

date_fromstringpattern ^\d{4}-\d{2}-\d{2}$

date_tostringpattern ^\d{4}-\d{2}-\d{2}$

orderstring (enum)ascdesc

pageintegerdefault 1min 1

per_pageintegerdefault 25min 1max 100

productstringmax length 3025

searchstringmax length 200

sortstring (enum)created_atupdated_atamountstatus

statusstring (enum)pendingapproveddeclinedreviewinvitedall

Request body

This operation takes no request body.

Response

200application/json

dataSerializedCaseSummary[]required

paginationobjectrequired

pagenumberrequired

per_pagenumberrequired

totalnumberrequired

total_pagesnumberrequired

Errors

The statuses this operation can return, with the error.code values behind each. Every error body is the shared envelope described under Errors in Getting started.

400validation_error

401unauthorized

403forbidden

429rate_limit_exceeded

500internal_error

Request

curl -X GET "https://<your-host>/api/v1/cases?page=1&per_page=25" \
  -H "Authorization: Bearer hlh_test_YOUR_API_KEY"

Response200application/json

{
  "data": [
    {
      "id": string,
      "applicant": string,
      "applicant_type": string,
      "product": string,
      "amount": number,
      "status": "pending" | "approved" | "declined" | "review" | "invited",
      "risk_score": number | null,
      "credit_score": number | null,
      "created_at": string | null,
      "updated_at": string | null
    }
  ],
  "pagination": {
    "page": number,
    "per_page": number,
    "total": number,
    "total_pages": number
  }
}

Shown as types, not sample values. A field typed number | null can be null; the response fields table gives the reason.