> ## Documentation Index
> Fetch the complete documentation index at: https://docs.1eye.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Destinations

> Retrieve a paginated list of configured Destinations and their delivery summaries.

Retrieve the Destinations configured in the workspace associated with your API key. A Destination delivers eligible Buyers or Signals to a connected platform, such as Salesforce, HubSpot, Slack, or a webhook.

```text theme={null}
GET /v1/destinations
```

## Authentication

All requests require a workspace API key:

```http theme={null}
Authorization: Bearer 1eye_live_xxxxxxxxx
```

The examples use `$API_KEY` for your API key. The key determines the workspace; you do not supply a workspace ID. See [Authentication](https://docs.1eye.ai/api-reference/auth.md).

## Request

```bash theme={null}
curl "https://api.1eye.ai/v1/destinations?limit=100" \
  -H "Authorization: Bearer $API_KEY"
```

## Query parameters

| Parameter | Type | Description |
| - | - | - |
| `limit` | integer | Results per page. Default: `100`. Range: `1–1000`. |
| `cursor` | string | Opaque cursor returned by the previous page. |

No `sort_by`, `sort_order`, or `include_deleted` parameters are supported.

## Response

**200 OK**

```json theme={null}
{
  "total": 1,
  "data": [
    {
      "id": "des_123456789012345678",
      "client_id": "wor_123456789012345678",
      "name": "Salesforce – High-Intent Data Buyers",
      "type": "salesforce",
      "status": "active",
      "workflow_id": "dwo_123456789012345678",
      "workflow_status": "running",
      "target_list_ids": [
        "lis_123456789012345678"
      ],
      "delivery_behavior": "push_retroactively",
      "push_behavior": "once_per_buyer",
      "is_connected": true,
      "console": {
        "total": 20,
        "pushed": 18,
        "pending": 1,
        "failed": 1
      },
      "created_by": {
        "id": "usr_123456789012345678",
        "type": "admin",
        "name": "Jane Doe",
        "profile_pic": "https://example.com/photo.jpg",
        "title": "Revenue Operations"
      },
      "created_at": "2026-10-18T18:00:00Z",
      "updated_at": "2026-10-20T18:00:00Z"
    }
  ],
  "pagination": {
    "next_cursor": null
  }
}
```

All names, domains, identifiers, amounts, URLs, and timestamps in these examples are illustrative.

Each item uses the [Destination object](https://docs.1eye.ai/api-reference/retrieve-a-destination.md), including its overall Console counts. `total` counts Destinations, not delivery attempts or Buyers.

## Pagination

Pass `pagination.next_cursor` unchanged to retrieve the next page. Stop when it is `null`.

```bash theme={null}
curl "https://api.1eye.ai/v1/destinations?limit=100&cursor=YOUR_CURSOR" \
  -H "Authorization: Bearer $API_KEY"
```

An empty collection returns `total: 0`, `data: []`, and `pagination.next_cursor: null`.

## Behavior

* Returns active Destinations accessible to the authenticated workspace.
* Excludes deleted Destinations.
* Distinguishes Destination lifecycle `status` from `workflow_status` and connection configuration.
* Returns source Target List IDs without embedding the lists or Buyer records.
* Does not create, update, delete, start, stop, reconnect, or retry a Destination.

To inspect individual delivery outcomes, use [Retrieve Destination Console](https://docs.1eye.ai/api-reference/retrieve-destination-console.md).

## Errors

| Status | Error code | Description |
| - | - | - |
| 400 | `invalid_parameter` | A request field or query parameter is invalid. |
| 400 | `invalid_cursor` | The cursor is malformed or does not match the endpoint. |
| 401 | `authentication_error` | The API key is missing, invalid, or revoked. |
| 403 | `permission_denied` | The key does not have permission for this operation. |
| 429 | `rate_limit_exceeded` | The workspace API rate limit was exceeded. |
| 500 | `internal_error` | An unexpected server error occurred. |
| 503 | `service_unavailable` | The service is temporarily unavailable. |

Errors use the standard [error envelope](https://docs.1eye.ai/api-reference/errors.md). Use `request_id` when contacting support.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.