1eye Docs – Buyer Signals API, Webhooks, MCP & Integrations

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.

GET /v1/destinations

Authentication

All requests require a workspace API key:

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.

Request

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

{
  "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, 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.

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.

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. Use request_id when contacting support.

Get Started

Buyers

Signals

Target Lists

Destinations

Knowledge Base

Workspace

List Destinations

Authentication

Request

Query parameters

Response

Behavior

Errors

​Authentication

​Request

​Query parameters

​Response

​Pagination

​Behavior

​Errors

Authentication

Request

Query parameters

Response

Pagination

Behavior

Errors