Check query status and execution results.

Cost

Free.

Auth

Required header:

x-elfa-api-key: <api_key>

Request Example

Path parameter:

• queryId (string)

Response Example (200)

{
  "queryId": "76e2e824-fc47-4d60-99b1-c227fbd2d3f5",
  "status": "active",
  "credits": 0,
  "latestEvaluation": {
    "evaluatedAt": "2026-04-01T12:00:00.000Z",
    "conditionStates": [
      {
        "index": 0,
        "source": "price",
        "method": "current",
        "args": { "symbol": "BTC" },
        "currentValue": 97250.5,
        "targetValue": 100000,
        "operator": "<",
        "isMet": true,
        "lastUpdated": "2026-04-01T12:00:00.000Z"
      }
    ],
    "wouldTriggerNow": true,
    "matchingConditions": 1,
    "totalConditions": 1
  },
  "executions": [
    {
      "id": "a12d20ff-6cb2-433e-afed-cc2e6a0380b6",
      "queryId": "76e2e824-fc47-4d60-99b1-c227fbd2d3f5",
      "type": "notification",
      "status": "success",
      "details": { "notification": { "channel": "webhook" } },
      "triggerTime": "2026-04-01T12:00:00.000Z",
      "conditionsMet": 1,
      "trigger": {
        "type": "price",
        "time": "2026-04-01T12:00:00.000Z",
        "matchedConditions": [
          {
            "condition": {
              "source": "price",
              "method": "current",
              "args": { "symbol": "BTC" },
              "operator": "<",
              "value": 100000
            },
            "match": { "observedValue": 97250.5 }
          }
        ]
      },
      "createdAt": "2026-04-01T12:00:01.000Z"
    }
  ]
}

latestEvaluation is the latest current-state snapshot. Auto Trigger Context (triggerTime, conditionsMet, trigger) explains what fired for an execution and uses the same public redaction boundary as outbound delivery payloads.

Best practice: use polling for debugging or backfills. For production delivery, prefer webhook/SSE notifications.