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

# List Sources

`GET /api/v1/sources/`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/v1/sources/`
- Auth: HTTP bearer

List the sources you've created, newest first. Only sources whose type is supported by this API are returned (data feeds not exposed by this API are omitted).

Each entry's `source_instance_id` is the source INSTANCE UUID — pass it to `POST /api/v1/sources/{source_instance_id}/sync` to connect it to a workflow. `source_id` is the source-type slug used by the preview / create / options endpoints.

## Response `200`

Default Response

- object
  - `status` integer
  - `data` SourceListItem[]: The caller's sources, newest first.
    - `source_instance_id` string, required: Source instance UUID — pass to `POST /api/v1/sources/{source_instance_id}/sync` or `GET /api/v1/sources/{source_instance_id}/data`.
    - `name` string, required: Display name given at creation.
    - `source_id` string, required: Public source-type slug (e.g. `import_from_hubspot`, `find_companies`) — the identifier used by preview / create / options.
    - `status` string: Source status: `active` (live, re-importing), `completed` (one-time import, won't refresh), `paused`, `paused_out_of_credits`, `expired`, or `deleted`.
    - `lead_count` integer, nullable: Rows imported so far.
    - `created_at` string, date-time: UTC creation timestamp.
    - `expiration_date` string, nullable: When an active source stops firing.

## Other responses

- `401`: Unauthorized — missing or invalid API key
- `403`: Forbidden. `code` says which permission refused: ROLE_FORBIDDEN (your role), INSUFFICIENT_SCOPE (the API key's scopes), WORKFLOW_FORBIDDEN (no access to the workflow), KEY_WORKFLOW_FORBIDDEN (the API key's workflow restriction).
- `429`: Too Many Requests — rate limit exceeded. Check `Retry-After` header for seconds until the limit resets.

---

[API](https://skmtc.dev/floqer/apis/floqer-public-api.md) - [All operations](https://skmtc.dev/floqer/apis/floqer-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/floqer/apis/floqer-public-api/revisions/fce50dc07b20?raw)