Get a run

Returns one run. On a failed run, error carries { code, providerStatus, message, requestId, whoseError, retryable, retryHint }, never secrets or raw provider headers.

Since 2026-09-27 a completed run can carry an optional normalized object next to result: { job, endpointId, fields, missing, ambiguous, unmapped, providerValues, verdict, verdictReason, mapVerified }, with fixed field names per job and one email status vocabulary (valid, invalid, catch_all, risky, unknown). It is present only when the gateway has it turned on and the answering endpoint has an output map; otherwise it is absent, never null. result and outcome are unchanged.

GET/v1/runs/{runId}

Authorization

AuthorizationBearer token · headerrequired

Path parameters

runIdstringrequired

The run id POST /v1/runs returned. The value shown is a placeholder.

Responses

200

Success

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer tokenRemember on this deviceInclude my values in samples

Parameters

runIdpath*The run id POST /v1/runs returned. The value shown is a placeholder.

Request

curl -X GET "https://api.looot.ai/v1/runs/run_0123456789abcdef0123456789abcdef" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.looot.ai/v1/runs/run_0123456789abcdef0123456789abcdef", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.looot.ai/v1/runs/run_0123456789abcdef0123456789abcdef",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "runId": "run_0123456789abcdef0123456789abcdef",
  "endpointId": "hunter-email-finder",
  "status": "completed",
  "providerResponseStatus": "ok",
  "createdAt": "2026-09-24T21:14:36.435Z",
  "startedAt": "2026-09-24T21:14:36.781Z",
  "completedAt": "2026-09-24T21:14:37.377Z",
  "input": {
    "first_name": "Jane",
    "last_name": "Doe",
    "domain": "example.com"
  },
  "outcome": "hit",
  "actualCost": 0.0245,
  "result": {
    "data": {
      "email": "jane.doe@example.com",
      "score": 94
    }
  },
  "error": null
}