---
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}/`

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

---

[API](https://skmtc.net/truv/apis/truv-api.md) · [All operations](https://skmtc.net/truv/apis/truv-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/truv/truv-api/revisions/b92671dcb52d/schema)