SteveSteve

List submissions

GET/api/v1/submissions

Authorization

AuthorizationRequiredBearer <token>

Company-scoped Steve API key. Format: Authorization: Bearer aok_...

In: header

Query Parameters

workflowstring

Filter submissions to a single workflow slug.

statusstring

Filter submissions by public business status.

Value in: "created" | "processing" | "review" | "approved" | "synced" | "rejected" | "cancelled" | "failed"
fraudStatusstring | null

Filter submissions by fraud state.

Value in: "clean" | "flagged" | "blocked" | null
cursorstring

Opaque pagination cursor returned by a previous response.

limitinteger

Page size. Steve clamps values to the range 1..100.

Default: 20Minimum: 1Maximum: 100

Header Parameters

X-Request-Idstring

Optional caller-supplied request identifier. Maximum length is 128 characters.

Maximum length: 128
curl -X GET "https://your-deployment.convex.site/api/v1/submissions?workflow=%3Cstring%3E&status=created&fraudStatus=clean&cursor=%3Cstring%3E&limit=20" \
  -H "X-Request-Id: <string>" \
  -H "Authorization: Bearer <token>"

Matching submissions

{
  "data": [
    {
      "id": "string",
      "submissionStatus": "created",
      "fraudStatus": "clean",
      "fraudScore": 0,
      "workflow": {
        "slug": "string",
        "name": "string",
        "version": 0
      },
      "extractedData": null,
      "confidence": 0,
      "createdAt": "2019-08-24T14:15:22Z",
      "clientSubmissionId": "string"
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "string"
  }
}

Previous

Submit a workflow session for processing

Next

Get submission detail