REST API

Resolve a company from either side.

Send a domain to get the UK company, or send a company number to get its verified website.

Base URL: https://api.truingdata.com. Authenticate with x-api-key: proj_live_....

Get an API key

Create an account in the Truing workspace. Your key is shown once when it is created.

Resolve a domain

curl -X POST https://api.truingdata.com/v1/resolve/domain \
  -H "content-type: application/json" \
  -H "x-api-key: proj_live_..." \
  -d '{"domain":"example.co.uk"}'

A known result returns 200. Fresh work returns 202 with a status_url to poll.

Resolve a company

curl -X POST https://api.truingdata.com/v1/resolve/company \
  -H "content-type: application/json" \
  -H "x-api-key: proj_live_..." \
  -d '{"company_number":"01234567"}'

Add "refresh": true only when you need a fresh reverse-domain search.

Understand the result

matched

One company confidently connected.

1 resolution

needs_review

Possible companies need human review.

free

no_match

No reliable company connection was found.

free

verified

A company was connected to its website.

1 resolution