Steve API
API Reference

Get session job status

Polls the async state of a Steve `apiSession`.

GET
/api/v1/jobs/{sessionId}

Authorization

AuthorizationRequiredBearer <token>

In: header

Path Parameters

sessionIdRequiredstring

Steve session identifier stored in apiSessions.

curl -X GET "https://your-deployment.convex.site/api/v1/jobs/<string>" \
  -H "Authorization: Bearer <token>"

Current session state returned successfully.

{
  "sessionId": "jx7ses789session",
  "status": "complete",
  "result": {
    "extractedData": {
      "invoiceNumber": "INV-2026-001",
      "totalAmount": 1234.56
    },
    "confidence": 0.94
  },
  "webhookDeliveryStatus": "delivered"
}