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

# Get signal

> Fetch a single signal with its access records

`GET /api/v2/storefront/signals/{signalId}`

Returns one signal by its identifier, including its access records.

## Request

```bash curl theme={null}
curl https://api.interchange.io/api/v2/storefront/signals/acme_high_value_customers \
  -H "Authorization: Bearer $SCOPE3_API_KEY"
```

## Parameters

| Field      | Type   | Required | Notes                    |
| ---------- | ------ | -------- | ------------------------ |
| `signalId` | string | Yes      | Signal identifier (path) |

## Response

```json theme={null}
{
  "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,
      "advertiserId": 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 account.
* `401 UNAUTHORIZED` — missing or invalid bearer token.

See [Errors](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Signal tasks" href="/v2/storefront/signals/tasks" icon="list-check">
    All signal operations
  </Card>

  <Card title="List signals" href="/v2/storefront/signals/tasks/list-signals" icon="list">
    Filterable, paginated list
  </Card>

  <Card title="Update signal" href="/v2/storefront/signals/tasks/update-signal" icon="pen">
    Change metadata and access records
  </Card>

  <Card title="Signal overview" href="/v2/object-guides/signal" icon="wave-pulse">
    Fields, lifecycle, and concepts
  </Card>
</CardGroup>