company_mapping_id is passed directly into Truv Bridge, the user skips the search step entirely and goes straight to authentication.
Check a company’s
success_rate and mapping_status before creating an order to optimize the user experience and decide whether to fall back to document upload.Attributes
| Attribute | Type | Description |
|---|---|---|
company_mapping_id | String | Unique company identifier. Pass to Truv Bridge to bypass employer search. |
name | String | Company name |
domain | String | Unique web domain of the company |
logo_url | String | URL to the company’s logo |
confidence_level | Float | Predicted success rate (0.0–1.0; values ≥ 0.5 indicate high success) |
success_rate | String | Classification: "high", "low", "unsupported", or null |
mapping_status | String | Integration status: "verified", "mapped", or "unmapped" |
Endpoints
Company Autocomplete Search
Search companies by name with autocomplete. Use results to populate or pre-fill Truv Bridge.
Company Info
Retrieve detailed attributes for a specific company by its mapping ID
Company Mapping
Map a domain or company name to a Truv company record and mapping ID
Example response
Common use cases
Pre-fill Truv Bridge (skip employer search)
Pre-fill Truv Bridge (skip employer search)
Search for a company using the autocomplete endpoint, retrieve its
company_mapping_id, and pass it directly to Truv Bridge. The user lands straight on the login screen for their employer. No search step needed.Coverage check before creating an order
Coverage check before creating an order
Use
success_rate and mapping_status to decide whether to offer payroll-based verification or prompt the user to upload documents instead.success_rate | mapping_status | Recommendation |
|---|---|---|
"high" | "verified" | Proceed with payroll verification |
"low" | "mapped" | Offer document upload as primary path |
"unsupported" | "unmapped" | Skip payroll. Go straight to document upload. |