Signalby Metrics Hive
Start

Get a run

GET
/prompts/{promptId}/runs/{runId}

One model answer, with its text normalized out of the provider’s response and its citations in the order the engine listed them. A run belonging to some other prompt answers 404. The provider’s raw payload is deliberately not exposed — its shape belongs to the provider, not to this API.

Authorization

BearerAuth
headerAuthorizationBearer <token>

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

Path Parameters

promptId*string
Formatuuid
runId*string
Formatuuid

Response Body

Get a run

application/json
  1. response

One model answer with its normalized text and citations.

id*string
Formatuuid
promptId*string
Formatuuid
brandId*string
model*string
provider*|

How the answer was obtained. Informational; not a stable enum.

webSearchEnabled*boolean

Whether the engine answered with its own web search on.

brandMentioned*boolean
competitorsMentioned*array<string>
assessments*|

Experimental — the shape may still change.

The mention judge's assessments for one answer. Null when the run's mentions were matched by name, before the judge, until a replay judges it.

webQueries*array<string>

Searches the engine ran, where it exposes them.

citationCount*integer
createdAt*string
Formatdate-time
answer*
citations*array<>
Example Request
curl -X GET 'https://app.signal.metricshive.com/api/v1/prompts/497f6eca-6276-4993-bfeb-53cbbbba6f08/runs/497f6eca-6276-4993-bfeb-53cbbbba6f08'
Example Response
{
  "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",
  "answer": {
    "text": "string"
  },
  "citations": [
    {
      "url": "http://example.com",
      "domain": "string",
      "title": "string",
      "citationIndex": 0
    }
  ]
}