# List crm connections

`GET` `/api/v1/crm-connections`

Return the CRM connections in the account linked to the API key that the
key may see. Results are sorted by creation date, newest first.

## Query parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| type | string | no | Filter by CRM type: SALESFORCE or HUBSPOT |
| crm_environment | string | no | Filter by environment: PRODUCTION or SANDBOX |
| status | string | no | Filter by status: ACTIVE, INACTIVE, or ALL (default: ACTIVE) |
| query | string | no | Case-insensitive substring search on org name or instance URL |

## Response

`200 OK` — `application/json`

| Field | Type | Description |
|-------|------|-------------|
| id | string | Unique identifier (UUID) of the CRM connection |
| type | string | CRM type: SALESFORCE or HUBSPOT |
| status | string | Connection status: ACTIVE or INACTIVE |
| org_name | string | CRM org display name |
| instance_url | string | CRM instance URL |
| crm_environment | string | Environment: PRODUCTION or SANDBOX |
| is_primary | boolean | Whether this is the primary CRM connection for the account |
| created_at | string | ISO-8601 creation timestamp |
| updated_at | string | ISO-8601 last-updated timestamp |