Skip to main content
GET /api/v2/storefront/signals Returns a paginated list of signals registered on the storefront. Filter by owning agent, visibility, live status, or seat. Archived signals are excluded unless includeArchived is set.

​
Request

curl "https://api.interchange.io/api/v2/storefront/signals?visibility=PROPRIETARY&isLive=true&limit=50" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

FieldTypeRequiredNotes
agentIdstringNoFilter to one owning signals agent
visibilityenumNoPUBLIC or PROPRIETARY
isLivebooleanNoFilter to deployed signals only
seatIdintegerNoScope3 seat ID (int64)
includeArchivedbooleanNoInclude soft-deleted signals. Default false
limitintegerNoPage size, max 100. Default 20
offsetintegerNoResult offset. Default 0

​
Response

[
  {
    "id": 50213,
    "signalId": "acme_high_value_customers",
    "customerId": 1001,
    "adcpAgentId": null,
    "name": "Acme - High-Value Customers",
    "description": "Top 10% LTV customers, refreshed weekly",
    "keyType": ["rampid", "uid2"],
    "regions": ["NORAM", "EMEA"],
    "metadata": null,
    "isLive": false,
    "archivedAt": null,
    "createdBy": "agent@acme.example",
    "updatedBy": null,
    "createdAt": "2026-06-06T12:00:00Z",
    "updatedAt": "2026-06-06T12:00:00Z",
    "access": [
      {
        "id": 9001,
        "signalId": 50213,
        "seatId": 88421,
        "visibility": "PROPRIETARY",
        "price": null,
        "archivedAt": null,
        "createdAt": "2026-06-06T12:00:00Z",
        "updatedAt": "2026-06-06T12:00:00Z"
      }
    ]
  }
]
The data payload is an array of signal objects. Pagination metadata (skip, take, total, hasMore) is returned in the response envelope’s meta.pagination block — see Pagination.

​
Errors

  • 400 VALIDATION_ERROR — invalid visibility value or out-of-range limit.
  • 401 UNAUTHORIZED — missing or invalid bearer token.
See Errors for the full error contract.

Signal tasks

All signal operations

Get signal

One signal with access records

Create signal

Register a signal

Signal overview

Fields, lifecycle, and concepts