Skip to main content
Portal

Poll Query

GET 
/v2/auto/queries/:queryId
Plan Access
All plans, billed per query in credits
Data Recency
Continuous evaluation against live data
Rate Limit
60 to 120 RPM by plan

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.

Request​

Responses​

Ok