Signalby Metrics Hive
Start

List runs for a prompt

GET
/prompts/{promptId}/runs

Individual model answers behind the aggregates, newest first, without their text — the list stays small enough to page through. Fetch GET /prompts/{promptId}/runs/{runId} for the answer itself.

Authorization

BearerAuth
headerAuthorizationBearer <token>

An organization key (signal_…) created under Organization Settings → API Keys.

Path Parameters

promptId*string
Formatuuid

Query Parameters

start*string

Inclusive lower bound of the window, an ISO 8601 timestamp such as 2026-01-01T00:00:00Z. Aligned down to the quarter hour, the grain analytics are aggregated at; where a response repeats the window, it repeats the aligned one. A bare YYYY-MM-DD is rejected: that is /prompts/{promptId}/snapshot's spelling and means a local calendar day there.

Formatdate-time
end*string

Exclusive upper bound of the window, an ISO 8601 timestamp, also aligned down to the quarter hour. The window is half-open: a run at exactly end is outside it. start and end inside one quarter-hour bucket leave an empty window and are rejected.

Formatdate-time
model?string

Restrict to one model, e.g. chatgpt. See GET /models.

page?integer

Page number, 1-based.

Range1 <= value
Default1
limit?integer

Items per page. Values above the maximum are clamped, not rejected.

Range1 <= value <= 100
Default20

Response Body

List runs for a prompt

application/json
  1. response
data*array<>
pagination*
Example Request
curl -X GET 'https://app.signal.metricshive.com/api/v1/prompts/497f6eca-6276-4993-bfeb-53cbbbba6f08/runs?start=2019-08-24T14%3A15%3A22Z&end=2019-08-24T14%3A15%3A22Z'
Example Response
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "promptId": "b5415d63-4390-40ec-8c2b-33a2db2f5c67",
      "brandId": "string",
      "model": "string",
      "provider": "string",
      "webSearchEnabled": true,
      "brandMentioned": true,
      "competitorsMentioned": [
        "string"
      ],
      "assessments": {
        "brand": {
          "mentioned": true,
          "probability": 0,
          "reason": "string",
          "sentiment": "positive",
          "sentimentProbabilities": {
            "property1": 0,
            "property2": 0
          },
          "position": 1,
          "mentionCount": 1
        },
        "competitors": {
          "property1": {
            "mentioned": true,
            "probability": 0,
            "reason": "string",
            "sentiment": "positive",
            "sentimentProbabilities": {
              "property1": 0,
              "property2": 0
            },
            "position": 1,
            "mentionCount": 1
          },
          "property2": {
            "mentioned": true,
            "probability": 0,
            "reason": "string",
            "sentiment": "positive",
            "sentimentProbabilities": {
              "property1": 0,
              "property2": 0
            },
            "position": 1,
            "mentionCount": 1
          }
        }
      },
      "webQueries": [
        "string"
      ],
      "citationCount": 0,
      "createdAt": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "page": 0,
    "limit": 0,
    "total": 0,
    "totalPages": 0
  }
}