---
title: "Providers"
method: GET
path: "/providers"
tags: ["Management"]
---

# Providers

`GET /providers`

Return details on all available payroll and HR systems.

## Headers

- `Finch-API-Version` string, date, required

## Response `200`

OK

- Provider[]
  - `id` string, required — The id of the payroll provider used in Connect.
  - `display_name` string, required — The display name of the payroll provider.
  - `products` string[], required — The list of Finch products supported on this payroll provider.
  - `icon` string — The url to the official icon of the payroll provider.
  - `logo` string — The url to the official logo of the payroll provider.
  - `mfa_required` boolean — whether MFA is required for the provider.
  - `primary_color` string — The hex code for the primary color of the payroll provider.
  - `manual` boolean — [DEPRECATED] Whether the Finch integration with this provider uses the Assisted Connect Flow by default. This field is now deprecated. Please check for a `type` of `assisted` in the `authentication_methods` field instead.
  - `beta` boolean — `true` if the integration is in a beta state, `false` otherwise
  - `authentication_methods` object[] — The authentication methods supported by the provider.
    - `type` 'assisted' | 'credential' | 'api_token' | 'api_credential' | 'oauth' | 'api', required — The type of authentication method
    - `benefits_support` object — The supported benefit types and their configurations
    - `supported_fields` object — The supported fields for each Finch product

## Changes

> 53 revisions in range; 3 could not be searched.

- **2025-10-27** `0105d239fcaf` — 1 breaking, 22 warning, 5 info
  - the `items/authentication_methods/items/benefits_support/additionalProperties/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `items/authentication_methods/items/benefits_support/additionalProperties/supported_features` from the response with the `200` status
  - removed the optional property `items/authentication_methods/items/benefits_support/additionalProperties/supported_operations` from the response with the `200` status
  - removed the optional property `items/authentication_methods/items/benefits_support/commuter` from the response with the `200` status
  - …24 more
- …earlier changes not shown

[Full history](https://skmtc.dev/finch-api/apis/api-reference/changes/providers/get.md)

---

[API](https://skmtc.dev/finch-api/apis/api-reference.md) · [All operations](https://skmtc.dev/finch-api/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/finch-api/api-reference/revisions/f1cca2cb0ef2/schema)