API ReferenceSubmissions
GET
bearerAuthheader
AuthorizationBearer <token>API key authentication. Pass your ioZen API key as a Bearer token in the Authorization header.
id*stringIntake bot ID
submissionId*stringSubmission ID
Successful response
application/json- response
success*trueValue in
truedata*curl -X GET 'https://app.iozen.ai/api/v1/intake-bots/cm7abc12x0001yz9k8mno3pqr/submissions/cm7def45y0002yz9k8mno3pqr'Example Response
{ "success": true, "data": { "submission": { "id": "cm7sub01a0001yz9k8mno3pqr", "data": { "full_name": "Jane Doe", "email": "jane@example.com", "priority": "high" }, "status": "COMPLETED", "ai_summary": "New enterprise customer requesting priority onboarding.", "is_test": false, "file_count": 2, "schema_version": 3, "intake_bot_id": "cm7abc12x0001yz9k8mno3pqr", "messages": [ { "id": "cm7msg01a0001yz9k8mno3pqr", "role": "assistant", "content": "Welcome! What is your full name?", "created_at": "2026-02-22T11:00:00.000Z" }, { "id": "cm7msg02b0002yz9k8mno3pqr", "role": "user", "content": "Jane Doe", "created_at": "2026-02-22T11:00:30.000Z" } ], "created_at": "2026-02-22T11:00:00.000Z", "updated_at": "2026-02-22T11:05:00.000Z" } }}List submissions GET
Returns a paginated list of submissions for an intake bot, including the current field schema. Filter by `created_after` / `created_before` (ISO 8601) and `is_test` (`true` or `false`; omit for all).
Create submission POST
Creates a new submission for an intake bot. Validates field values against the bot's schema. Unknown field names are rejected. Supports idempotency via the Idempotency-Key header.