TrustRegistry
Sign inTry Playground
Getting started

Quickstart

Your first verified response in under two minutes. No SDK required — this is a standard REST API and any HTTP client will work.

1. Create an API key

Sign in and open Dashboard → API Keys. Click Create key and copy the tr_live_… value — it is shown once and stored only as a SHA-256 hash on our side.

2. Make your first request

curl
curl -X POST https://trustregistryapi.com/api/v1/verify \
  -H "Authorization: Bearer $TRUSTREGISTRY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "business_name": "H-E-B LP",
    "state": "TX"
  }'

3. Parse the response

200 OK
{
  "verified": true,
  "status": "active",
  "business_name": "<canonical name from registry>",
  "entity_type": "<from registry, may be null>",
  "state": "TX",
  "registration_number": "<from registry, may be null>",
  "formation_date": "<ISO date, may be null>",
  "confidence_score": 0.97,
  "source": "Texas Comptroller — Active Franchise Tax Permit Holders",
  "data_source": "live_registry_ingestion",
  "trustregistry_id": "be_..."
}

verified is true when an active matching entity is found. confidence_score is a match-quality indicator in [0, 1] — not a statistical probability. See the response contract for every shape we return.

Language examples

There is no official SDK yet. Use the HTTP client native to your language — fetch, requests, net/http, etc.

javascript / typescript
const res = await fetch("https://trustregistryapi.com/api/v1/verify", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TRUSTREGISTRY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    business_name: "ABC Logistics LLC",
    state: "TX",
  }),
});

if (!res.ok) {
  const { error } = await res.json();
  throw new Error(`${error.code}: ${error.message}`);
}

const result = await res.json();
console.log(result.verified, result.confidence_score);
python
import os, requests

resp = requests.post(
    "https://trustregistryapi.com/api/v1/verify",
    headers={"Authorization": f"Bearer {os.environ['TRUSTREGISTRY_KEY']}"},
    json={"business_name": "ABC Logistics LLC", "state": "TX"},
    timeout=10,
)
resp.raise_for_status()
data = resp.json()
print(data["verified"], data["confidence_score"])
Next steps