Name Lookup Search by ID

Retrieve a single Name Lookup request by UUID, including related match records.

  • ID is the unique request UUID.
  • Status can be (Pending, Processing, Completed, Error).
  • name_available (when completed) can be (Yes, No, Partial).

Optional query parameter search_query filters nested match records by entity name, entity number, status, state, or UUID.

{
    "success_message": "Request retrieved successfully.",
    "data": {
        "id": "0199c0a1-2b3d-7e8f-9a0b-1c2d3e4f5a6b",
        "status": "Completed",
        "name_available": "Yes",
        "business_name": "Acme Analytics",
        "state": "california",
        "webhook_urls": ["https://example.com/hooks/name-lookup"],
        "created_at": "2026-08-18T10:16:14.123456Z",
        "created_by": "[email protected]",
        "records": [
            {
                "id": "0199c0a1-3c4d-7e8f-9a0b-1c2d3e4f5a6c",
                "entity_name": "ACME ANALYTICS LLC",
                "entity_number": "202412345678",
                "status": "Active",
                "state": "CA",
                "match_percentage": 92
            }
        ]
    },
    "success": true
}
{
    "errors": [
        {
            "code": "ID",
            "message": "Invalid ID format. ID must be a valid UUID."
        }
    ],
    "data": null,
    "success": false
}
{
    "errors": [
        {
            "code": "ID",
            "message": "Record with this ID does not exist"
        }
    ],
    "data": null,
    "success": false
}
{
    "errors": [
        {
            "code": "ID",
            "message": "You don't have permission to access this record"
        }
    ],
    "data": null,
    "success": false
}
{
    "detail": "Invalid token."
}
{
    "detail": "Authentication credentials were not provided."
}
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Query Params
string

Filter match records by entity name, entity number, status, state, or UUID

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json