signals

Look up signals by ID

Fetch up to 500 ingested signals (usage events) by ID in one request, each with the data payload submitted at ingest. Use it to resolve the signalId values on a page of credit transactions, or the signals behind one run or ticket, instead of calling GET /api/v2/signals/{id} once per signal. Signals are returned in request order; IDs that match nothing in your organization are listed under notFound rather than failing the request. This is a read-only operation: it requires the read:usage scope and is not available to customer API keys.

post/signals/lookup

Request

  • Base URL: https://api.agentpaid.io/api/v2
  • URL: https://api.agentpaid.io/api/v2/signals/lookup
  • Auth: HTTP bearer

Request body

idsstring[] required

Signal IDs to fetch, up to 500 per request. Duplicates are collapsed. For example the signalId values from a page of GET /api/v2/credits/transactions.

Response

200

notFoundstring[] required

Requested IDs that match no signal in your organization, in request order. Malformed IDs are reported here rather than rejected.

Changes

No recorded changes to this operation across all 1 revision of this API.