---
title: "List Contact Sources"
method: GET
path: "/api/v1/contact-sources"
tags: ["businesses"]
---

# List Contact Sources

`GET /api/v1/contact-sources`

Every connected contact source, with the state of its last sync.

One shape per source rather than one endpoint per vendor: the panel that
renders this does not know what HubSpot is, which is what lets a second
source appear in it without a frontend change.

## Response `200`

Successful Response

- ContactSourceListResponse — Every contact source this tenant has connected. Empty is the normal case — most tenants have nothing connected — and the panel says so rather than rendering an error.
  - `sources` ContactSourceRead[]
    - `source_key` string, required
    - `label` string, required
    - `supports_incremental` boolean, required
    - `last_run` ImportRunRead — Status of a bulk-sync run, for the progress UI. ``source_key`` names the contact source, ``report_only`` says whether the run wrote anything, and ``counters`` holds the seven every source reports. The HubSpot-named counters are the legacy pair the current progress UI still reads.
      - `id` string, uuid, required
      - `provider` string, required
      - `source_key` string, required
      - `status` string, required
      - `phase` string, required
      - `report_only` boolean, required
      - `counters` object
      - `contacts_imported` integer, required
      - `contacts_updated` integer, required
      - `contacts_skipped` integer, required
      - `companies_imported` integer, required
      - `companies_updated` integer, required
      - `associations_made` integer, required
      - `error_message` string, nullable
      - `started_at` string, date-time, nullable
      - `finished_at` string, date-time, nullable
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
  - `sync_enabled` boolean

---

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