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 first.The server checks account access, billing capacity, and confirmation before a billable PPSR search runs.
Endpoints
Section titled “Endpoints”POSThttps://api.assets.hoistai.com/v1/ppsr/preview
POSThttps://api.assets.hoistai.com/v1/ppsr/search
Supported subjects
Section titled “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 + type |
| Individual | Not available in Hoist Assets. | Unsupported |
Request pattern
Section titled “Request pattern”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 https://api.assets.hoistai.com/v1/ppsr/search \ -H "Authorization: Bearer $HOIST_ASSETS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"subject_kind":"serial_number","serial":"506066341","type":"motor","purpose":"settlement check"}'Response shape
Section titled “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.