Register search
PPSR search
Run organisation-grantor and serial-number PPSR searches for approved accounts. Hoist Assets is org-only: organisation and serial-number searches are supported; individual-grantor searches are not.
!Preview before paid dispatch. The server checks account access, billing capacity, and confirmation before a billable PPSR search runs.
Endpoints
POSThttps://api.assets.hoistai.com/v1/ppsr/preview
POSThttps://api.assets.hoistai.com/v1/ppsr/search
Supported subjects
| Subject | Use it for | Required field |
|---|---|---|
| Organisation | Security interests registered against an Australian company or organisation. | acn |
| Serial number | VIN, chassis, aircraft, watercraft, and other serial-numbered assets. | serial_number |
| Individual | Not available in Hoist Assets. | Unsupported |
Request pattern
Use /ppsr/preview to show the user the search subject and cost posture. Use /ppsr/search only after the human or workflow has confirmed a paid dispatch.
curl - PPSR organisation preview
curl https://api.assets.hoistai.com/v1/ppsr/preview \
-H "Authorization: Bearer $HOIST_ASSETS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"subject_kind":"organisation","acn":"123456789"}'curl - PPSR serial search
curl https://api.assets.hoistai.com/v1/ppsr/search \
-H "Authorization: Bearer $HOIST_ASSETS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"subject_kind":"serial","serial_number":"506066341","purpose":"settlement check"}'Response shape
A successful search returns a search reference, source status, registrations when present, billable cost context, and certificate metadata when a source certificate is available.
search_ididentifies the search for activity and receipt lookups.registerisPPSRfor this surface.certificate_sha256is present when the source certificate has been recorded.billableand cost fields show the paid dispatch posture.