// Enterprise KYB · Getting Started

Enterprise Quickstart

Integrate the Osapher KYB API and verify your first AU/NZ business entity in under 5 minutes.

This guide is for developers integrating the Osapher KYB API into their compliance systems. If you are using the SMB platform, see the SMB Quickstart instead.

Before you start: You need an Enterprise account at enterprise.osapher.com. The free trial includes full API access.

Prerequisites

  • A Osapher Enterprise account (free trial available)
  • An Australian ABN or New Zealand NZBN to test with
  • curl, Postman, or any HTTP client

Get your API key

Log in to enterprise.osapher.com/api-keys and create a new API key. Copy the key — it will only be shown once.

Your API key looks like this:

api key
vnt_ent_live_xxxxxxxxxxxxxxxxxxxxxxxx

Keep your API key secret. Never expose it in client-side code, browser environments, or public repositories.

Run your first verification

Send a POST request to /api/enterprise/verify with your ABN or NZBN:

shell
curl -X POST https://app.osapher.com/api/enterprise/verify \
  -H "Authorization: Bearer vnt_ent_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "queryValue": "YOUR_ABN_HERE",
    "jurisdiction": "AU"
  }'

For a New Zealand entity, use jurisdiction: "NZ" and provide a 13-digit NZBN:

shell
curl -X POST https://app.osapher.com/api/enterprise/verify \
  -H "Authorization: Bearer vnt_ent_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "queryValue": "YOUR_NZBN_HERE",
    "jurisdiction": "NZ"
  }'

Read the response

A successful verification returns a 200 response with the following shape:

response
{
  "result": {
    "legalName": "Acme Corp Pty Ltd",
    "abn": "11111111111",
    "jurisdiction": "AU",
    "entityType": "Individual/Sole Trader",
    "abnStatus": "Active",
    "gstRegistered": "Not registered",
    "fractureScore": 0,
    "fractureRisk": "low",
    "fractureSignals": [],
    "status": "verified"
  }
}

The fractureScore is Osapher's risk metric — 0 is cleanest, 100 is highest risk. See Fracture Score™ for full documentation.

FieldTypeDescription
legalNamestringLegal name from the government registry
abnstringAustralian Business Number (AU only)
fractureScorenumberRisk score 0–100. Lower is better.
fractureRiskstringRisk band: low, medium, high, critical
fractureSignalsarrayRisk signals that contributed to the score
statusstringverified, not_found, or error

Next steps

Authentication