ABN lookup and GST verification

Hoist exposes two related but distinct paths: the direct ABN endpoint returns entity and ABN-registration fields, while counterparty verification can add source-attributed GST evidence.

Use as source data.ABN and GST checks support due diligence and workflow automation. They are source-backed data points, not tax, credit, or legal advice.

Direct ABN endpoint

GEThttps://api.assets.hoistai.com/v1/abn/{abn}

What the direct lookup returns

Field group	Typical use	Examples
Identity	Confirm the business identifier and display name.	`abn`, entity name, entity type
Registration	Check whether the ABN is active or cancelled.	ABN status, effective dates
Source context	Show where the entity record came from and whether the response used live or mock data.	`sourceUrl`, `data_mode`

Request pattern

curl https://api.assets.hoistai.com/v1/abn/11695718659 \
  -H "Authorization: Bearer $HOIST_API_KEY"

Response shape

{
  "ok": true,
  "abn": "11695718659",
  "entityName": "Example Pty Ltd",
  "entityType": "Australian Private Company",
  "status": "Active",
  "abnRegisteredDate": "2025-01-01",
  "acn": "123 456 789",
  "state": "NSW",
  "postcode": "2000",
  "sourceUrl": "https://abr.business.gov.au/ABN/View?id=11695718659",
  "data_mode": "live"
}

The direct response does not contain gst_status, GST effective dates, retrieved_at, or a confidence field. Show sourceUrl, data_mode, and the returned status alongside the answer.

GST evidence endpoint

Use counterparty verification when the workflow needs GST evidence:

POSThttps://api.assets.hoistai.com/v1/verify-counterparty

curl https://api.assets.hoistai.com/v1/verify-counterparty \
  -H "Authorization: Bearer $HOIST_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"abn":"11695718659"}'

The token must carry both abn:lookup and gst:status. The response is an Evidence Card rather than the direct ABN response shape; inspect card.source_checks for the source-attributed ABR GST result and its limitations.

Current ABN and GST verification is free. These calls do not reserve or increment metered usage and are not blocked by a paid-search cap.