Skip to main content
A Data Provider is the underlying system that stores user data: payroll platforms (e.g., ADP, Workday, Gusto), banks (e.g., Chase, Wells Fargo), and insurance carriers. Each company typically maps to one data provider. Use the Data Providers endpoints to check which providers Truv supports, verify coverage for a specific product type, and retrieve provider details before creating orders. Filter by product_type and data_source to find providers relevant to your use case.

Supported product types

income, employment, deposit_switch, pll, insurance, transactions, assets, admin

Supported data sources

payroll, financial_accounts, insurance
Before creating an order, confirm that the user’s provider supports your product type by checking the is_disabled field and success_rate.

Attributes

AttributeTypeDescription
idStringUnique data provider identifier
nameStringData provider name (e.g., ADP, Chase, Gusto)
data_sourceStringProvider category: payroll, financial_accounts, or insurance
logo_urlStringURL to the provider’s logo
is_disabledBooleanWhether the provider is currently disabled
success_rateStringConnection success classification: "high", "low", or null

Endpoints

List Data Providers

Retrieve all data providers filtered by product type and data source

Retrieve Data Provider

Get details for a specific data provider by ID

Example response

{
  "count": 123,
  "results": [
    {
      "id": "adp",
      "name": "ADP",
      "data_source": "payroll",
      "logo_url": "https://citadelid-resources.s3-us-west-2.amazonaws.com/adp.png",
      "is_disabled": false,
      "success_rate": "high"
    }
  ],
  "next": "<string>",
  "previous": "<string>"
}