---
title: "List Crm Lists"
method: GET
path: "/api/crm/lists"
tags: ["growth-artifact-jobs"]
---

# List Crm Lists

`GET /api/crm/lists`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/crm/lists`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

Search provider-owned CRM lists without materializing their memberships.

## Query parameters

- `provider` 'hubspot'
- `object_type` 'contacts' | 'companies' | 'deals'
- `query` string, nullable
- `cursor` string, nullable
- `selected_id` string, nullable
- `limit` integer

## Response `200`

Successful Response

- CrmListSearchResponse
  - `lists` CrmListMetadata[], required
    - `created_at` string, nullable
    - `folder_name` string, nullable
    - `list_id` string, required
    - `name` string, required
    - `object_type` 'contacts' | 'companies' | 'deals', required
    - `object_type_id` string, required
    - `processing_status` string, required
    - `processing_type` 'MANUAL' | 'DYNAMIC' | 'SNAPSHOT', required
    - `size` integer, nullable
    - `updated_at` string, nullable
  - `next_cursor` string, nullable
  - `object_type` 'contacts' | 'companies' | 'deals', required
  - `provider` 'hubspot', required
  - `selected_list` CrmListMetadata
    - `created_at` string, nullable
    - `folder_name` string, nullable
    - `list_id` string, required
    - `name` string, required
    - `object_type` 'contacts' | 'companies' | 'deals', required
    - `object_type_id` string, required
    - `processing_status` string, required
    - `processing_type` 'MANUAL' | 'DYNAMIC' | 'SNAPSHOT', required
    - `size` integer, nullable
    - `updated_at` string, nullable
  - `selected_status` 'available' | 'unavailable', nullable
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)