---
title: "Returns the full integration provider registry"
method: GET
path: "/api/v2/supersearch-enrichment/integrations/providers"
tags: ["SuperSearchEnrichment"]
---

# Returns the full integration provider registry

`GET /api/v2/supersearch-enrichment/integrations/providers`

## Request

- Base URL: `https://api.instantly.ai`
- URL: `https://api.instantly.ai/api/v2/supersearch-enrichment/integrations/providers`
- Auth: HTTP bearer

Returns every data-provider integration with its available lookup actions, per-action credit cost, and whether the requesting workspace has connected its own provider account (isConnected). credentialSource names whose key runs the provider for the requesting workspace ("workspace_key", "instantly_key", or "unavailable" when neither side holds a usable key), and effectiveCostPerAction is what one action costs that workspace: 0 on the workspace key, creditCostPerAction otherwise, including when the source is "unavailable". Both fields are null for an internal service-to-service call, which has no workspace to resolve against.


Requires one of the following scopes: `supersearch_enrichments:read`, `supersearch_enrichments:all`, `all:read`, `all:all`

## Response `200`

Default Response

- object[]
  - `id` string
  - `name` string
  - `creditCostPerAction` number
  - `requiresUserConnection` boolean
  - `isFeatured` boolean
  - `isConnected` boolean
  - `credentialSource` 'workspace_key' | 'instantly_key' | 'unavailable' | 'null', nullable: Whose key runs this provider for the requesting workspace. Null for an internal caller with no workspace to resolve against.
  - `effectiveCostPerAction` number, nullable: Credits one action costs this workspace: 0 when it runs on the workspace key. Null when credentialSource is null.
  - `actions` object[]
    - `id` string
    - `name` string
    - `description` string
    - `outputColumn` string
    - `category` 'person' | 'company' | 'verification'
    - `subcategory` 'firmographics' | 'ads_marketing' | 'technology' | 'funding_investors' | 'jobs' | 'web_ecommerce'
    - `inputs` object[]
      - `key` string
      - `label` string
      - `required` boolean
      - `type` 'column' | 'text' | 'list'
      - `placeholder` string

## Other responses

- `401`: This request is unauthorized (either the Authorization header is missing or invalid, or the API key has been revoked)
- `402`: This request cannot be fulfilled because the workspace does not have an active paid plan
- `404`: The requested resource was not found
- `429`: You have exceeded the rate limit. Please check the rate limit docs for more information.

## Changes

- **2026-11-03** `c781051105a8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/instantly/apis/api-explorer/changes/api/v2/supersearch-enrichment/integrations/providers/get.md)

---

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