---
title: "Get company information"
method: GET
path: "/v1/companies/{company_mapping_id}/"
tags: ["Companies and Data Providers"]
---

# Get company information

`GET /v1/companies/{company_mapping_id}/`

## Request

- Base URL: `https://prod.truv.com`
- URL: `https://prod.truv.com/v1/companies/{company_mapping_id}/`
- Auth: API key in header `X-Access-Client-Id` and API key in header `X-Access-Secret`

The endpoint returns detailed information for a specific company mapping, including basic company details, success rate, and bank account information.

## Query parameters

- `product_type` 'income' | 'employment' | 'deposit_switch' | 'pll'

## Response `200`

- CompanyMappingDetail: Detailed information for a specific company mapping
  - `company_mapping_id` string, nullable: Company mapping ID
  - `name` string: Company name
  - `domain` string, nullable: Company domain
  - `logo_url` string, nullable: URL to company logo
  - `success_rate` 'low' | 'high' | 'unsupported' | 'null', nullable: Success rate for the company
  - `confidence_level` string: Confidence level for the company success rate. Range of possible values is from 0 to 1 with 0.5 and above being high success rate
  - `mapping_status` 'verified' | 'mapped' | 'unmapped': Mapping status of the company to the payroll system
  - `features` object: Company features information
    - `deposit_switch` object: Deposit switch features
      - `max_number` integer, nullable: Maximum number of bank accounts for this company
      - `deposit_types` string[]: List of supported deposit types for bank accounts
      - `amount_precision` '100' | '10' | '1' | '0.10' | '0.01' | 'null', nullable: Precision level for amount allocations
      - `percent_precision` '100' | '10' | '1' | 'null', nullable: Precision level for percentage allocations
    - `fill_rates` object: Fill rates for various data points (values from 0 to 1)
      - `job_title` number, float: Fill rate for job title data
      - `job_type` number, float: Fill rate for job type data
      - `is_active` number, float: Fill rate for active status
      - `start_date` number, float: Fill rate for start date data
      - `original_hire_date` number, float: Fill rate for original hire date data
      - `income` number, float: Fill rate for income data
      - `income_unit` number, float: Fill rate for income unit data
      - `pay_frequency` number, float: Fill rate for pay frequency data
      - `w2s` number, float: Fill rate for W2 documents
      - `paystubs` number, float: Fill rate for paystub documents

## Other responses

- `401`: HTTP 401 Unauthorized
- `403`: HTTP 403 Forbidden
- `404`: HTTP 404 Not Found

## Changes

- **2026-07-26** `e58688835e25`: 1 breaking
  - the response property `domain` became nullable for the status `200`

[Operation history](https://skmtc.dev/truv/apis/truv-api/changes/v1/companies/:company_mapping_id/get.md)

---

[API](https://skmtc.dev/truv/apis/truv-api.md) - [All operations](https://skmtc.dev/truv/apis/truv-api/llms.txt) - [OpenAPI document](https://skmtc.dev/truv/apis/truv-api/revisions/e20fd88e9371?raw)