Skip to main content

Poll Query

GET 
/v2/auto/queries/:queryId

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",
    "wouldTriggerNow": false
  },
  "executions": [
    {
      "id": "a12d20ff-6cb2-433e-afed-cc2e6a0380b6",
      "queryId": "76e2e824-fc47-4d60-99b1-c227fbd2d3f5",
      "type": "llm",
      "status": "failed",
      "error": {
        "code": "LLM_ACTION_UPSTREAM_ERROR",
        "message": "Failed to execute llm action"
      },
      "createdAt": "2026-04-01T12:00:01.000Z"
    }
  ]
}

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

Request​

Responses​

Ok