Asetrix API

Getting started

Create an account, generate an API key on your dashboard, and call the API with your key in the X-Api-Key header. Every response is JSON; timing is returned so you can see how fast it is.

Authentication

Pass your key on every request. Keys are scoped per service, so a CarValues key only works on CarValues endpoints.

curl -H "X-Api-Key: ask_live_xxx" \
  "https://api.asetrix.online/api/v1/vehicles/search?q=toyota%20hilux"

Search vehicles

Free-text search across make, model and variant. Returns ranked variants with a preview valuation.

Example response

{
  "hits": [{
    "kCode": "K370151041",
    "make": "TOYOTA", "model": "HILUX 2016 ON",
    "variant": "HILUX 2.8 GD-6 RAIDER 4X4 A/T P/U D/C",
    "yearFrom": 2016, "yearTo": 2026, "matchedYear": null,
    "valuation": { "retailValue": { "amount": 534100 }, "tradeValue": { "amount": 479500 } }
  }],
  "totalCandidates": 54,
  "elapsedMicroseconds": 180
}

Autocomplete

Type-ahead suggestions for a partial query.

Vehicle detail

Full detail for a variant: specification and valuation for every published year.

Brands & logos

A free, no-key, embeddable catalogue of every manufacturer we hold valuations for, each with a ready-to-use logo URL and variant count. Perfect for make dropdowns, filters and listing pages.

Example response

{
  "count": 318,
  "brands": [{
    "make": "TOYOTA",
    "slug": "toyota",
    "hasLogo": true,
    "logoUrl": "https://api.asetrix.online/api/v1/logos/toyota",
    "monogram": { "initials": "TO", "color": "#0E7490" },
    "variants": 934
  }]
}

No API key. CORS-enabled, cached for an hour. Also: GET /api/v1/brands/{make} for one brand.

Logo images

The manufacturer logo image, served straight from us. Drop it into an <img> with no key and no CORS hassle. Where we have a real logo you get a crisp PNG; otherwise you get a clean branded monogram, so the URL always returns an image (never a broken icon).

Embed it

<img src="https://api.asetrix.online/api/v1/logos/toyota" alt="Toyota" width="48">

Real logos are PNG, fallbacks are SVG monograms, all cached for a week. Logo artwork from the open car-logos dataset.

Data & Identity services

Credit, KYC, DHA, drivers licence, proof of address, trust and commercial reports, one key, billed per call. Every endpoint is a POST with a JSON body and your X-Api-Key; each successful call consumes one credit and returns the provider's response. Powered by licensed data partners.

curl -X POST "https://api.asetrix.online/api/v1/poa/verify" \
  -H "X-Api-Key: ask_live_xxx" -H "Content-Type: application/json" \
  -d '{"consumer":{"id_number":"8001015009087","consent":true}}'

Prefer no code? Every service also has a guided form on the site, fill in the fields and we run the check for you, billed to your wallet. Results render as a clean visual report (photo, identity, status badges and structured detail) with a Raw JSON tab for the full payload. Try a check.

Full Credit Report

A comprehensive consumer credit-bureau report, scores, accounts, enquiries and affordability, matching the CZ PDF output.

Request body

{
  "consumer": {
    "id_number": "8001015009087",
    "first_name": "Jane",
    "last_name": "Doe",
    "email_address": "jane.doe@example.com",
    "gross_income": 50000,
    "household_expenses": 10000,
    "reason": "Affordability Assessment",
    "consent": true
  }
}

Cartrust Vehicle Report

Full vehicle verification, title, finance, history and risk, for a VIN / registration.

Request body

{
  "requester_name": "Jane",
  "requester_surname": "Doe",
  "requester_email": "jane.doe@example.com",
  "requester_phone": "0123456789",
  "vin": "1BM5080EJP2113117",
  "RegistrationNumber": "CAA326768",
  "mileage": "20000",
  "vehicle_condition": "Good"
}

DHA / ID Verification

Home Affairs (DHA) identity verification against a South African ID number (cache mode).

Request body

{
  "IdNumber": "8001015009087",
  "CacheOnly": true
}

Drivers Licence, Enquiry

Real-time drivers-licence enquiry by ID or other identifier.

Request body

{
  "enquirer_name": "Jane",
  "enquirer_surname": "Doe",
  "individual_name": "John",
  "individual_surname": "Smith",
  "individual_id_no": "8001015009087"
}

Drivers Licence, Document

Drivers-licence document / manual-load verification.

Request body

{
  "id_number": "8001015009087",
  "first_name": "John",
  "last_name": "Smith"
}

Proof of Address

Confirm a consumer's residential / postal address from their ID number.

Request body

{
  "consumer": {
    "id_number": "8001015009087",
    "consent": true
  }
}

Trust Report

Trust entity verification and beneficiaries (records from 2004 onward).

Request body

{
  "consumer": {
    "trust_number": "IT021477/2014",
    "trust_name": "RAGHUBIR FAMILY TRUST",
    "consent": true
  }
}

Commercial Report

Company credit report, directors, financials and risk, for a registered business.

Request body

{
  "requester_name": "Jane",
  "requester_surname": "Doe",
  "business_name": "Example Trading (Pty) Ltd",
  "reg_number": "2020/123456/07"
}

KYC Pre-screen / Watchlist

Rapid identity pre-check against sanctions and PEP watchlists.

Request body

{
  "IDNumber": "8001015009087",
  "name": "John",
  "surname": "Smith",
  "dateOfBirth": "1980-01-01",
  "consentReceived": true
}

Onboarding, Create Applicant

Start an end-to-end onboarding journey for an applicant (then add watchlist, contact, status, PDF).

Request body

{
  "FirstName": "John",
  "LastName": "Smith",
  "IdNumber": "8001015009087",
  "DOB": "1980-01-01",
  "MobileNumber": "0820000000",
  "EmailAddress": "john.smith@example.com"
}

Errors & limits