Skip to main content
GET /api/v2/storefront/signals/{signalId} Returns one signal by its identifier, including its access records.

​
Request

curl
curl https://api.interchange.io/api/v2/storefront/signals/acme_high_value_customers \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

FieldTypeRequiredNotes
signalIdstringYesSignal identifier (path)

​
Response

{
  "signal": {
    "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": {
        "pricing_option_id": "po_cpm_standard",
        "pricing_model": "cpm",
        "currency": "USD",
        "fixed_price": 2.5
      },
      "archivedAt": null,
      "createdAt": "2026-06-06T12:00:00Z",
      "updatedAt": "2026-06-06T12:00:00Z"
    }
  ]
}
Each access record’s signalId is the numeric signal.id, not the string identifier.

​
Errors

  • 404 NOT_FOUND — no signal with that signalId is visible to the authenticated customer.
  • 401 UNAUTHORIZED — missing or invalid bearer token.
See Errors for the full error contract.

Signal tasks

All signal operations

List signals

Filterable, paginated list

Update signal

Change metadata and access records

Signal overview

Fields, lifecycle, and concepts