GET/v1/search

Search candidates

Fuzzy-search ranked candidate entities by name within a state. Use this when you have a rough name and need to disambiguate before calling /verify.

Request

GET /v1/search

GET /api/v1/search?name=abc+logistics&state=TX HTTP/1.1
Host: trustregistryapi.com
Authorization: Bearer tr_live_...

Query parameters

Param	Type	Required	Description
name	string	yes	Search term. Alias: `q`.
state	string (2-letter)	yes	USPS state code.

Response — 200 OK

response

{
  "query": { "name": "abc logistics", "state": "TX" },
  "count": 1,
  "results": [
    {
      "id": "be_...",
      "business_name": "ABC LOGISTICS LLC",
      "state": "TX",
      "registration_number": "0801234567",
      "entity_type": "LLC",
      "status": "active",
      "formation_date": "2021-03-14",
      "confidence_score": 1.0
    }
  ]
}

Up to 25 candidates are returned, sorted by descending confidence_score. Results below a 0.3 similarity floor are dropped.

Errors

See Errors.