TRtruv
Companies and Data Providers

Retrieve a data provider

Changed on

This endpoint retrieves a data provider.

get/v1/providers/{id}/

Request

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

Query parameters

product_type'income' | 'employment' | 'deposit_switch' | 'pll' | 'insurance' | 'transactions' | 'assets'
Example:income

Product type

Response

idstring required

ID of provider

namestring required

Data provider name

data_source'payroll' | 'docs' | 'insurance' | 'financial_accounts' | 'tax' | 'scoring_attributes' | 'credit' | 'education'

Source of data: payroll - payroll provider parsing, docs - user uploaded documents, insurance - insurance data, financial_accounts - bank data, tax - tax documents, scoring_attributes - transactions scoring attributes report.

logo_urlstring uri

Data provider logo URL

is_disabledboolean

True if product type for the query parameter product_type not implemented for the provider yet. If product_type query parameter is omitted the field will be null.

success_rate'low' | 'high' | 'unsupported' | 'null' nullable

Success rate for the provider

category'gig' | 'benefits' | 'w2' | 'financial_institution' | 'insurance' | 'tax' | 'education'

Category of the provider.

is_oauthboolean

Whether the provider has OAuth authentication enabled.

urlstring uri

The provider's website URL.

Example response

{
  "id": "adp",
  "name": "ADP",
  "data_source": "payroll",
  "logo_url": "https://cdn.truv.com/providers/adp.svg",
  "success_rate": "high",
  "category": "w2",
  "url": "https://www.adp.com/"
}

Changes

  • d7195c30b6b1Revision changes
    • info

      added the optional property //// to the response with the status

  • e58688835e25Revision changes
    • warning

      added the new credit enum value to the //// response property for the response status

    • warning

      added the new education enum value to the //// response property for the response status