API ReferenceSubmissions
Authorization
bearerAuth AuthorizationBearer <token>
API key authentication. Pass your ioZen API key as a Bearer token in the Authorization header.
In: header
Path Parameters
id*string
Intake bot ID
Query Parameters
limit?integer
Maximum number of items to return (1–100, default 50)
cursor?string
Cursor for pagination — use next_cursor from a previous response
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://app.iozen.ai/api/v1/intake-bots/cm7abc12x0001yz9k8mno3pqr/submissions"{
"success": true,
"data": {
"submissions": [
{
"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,
"message_count": 5,
"schema_version": 3,
"created_at": "2026-02-22T11:00:00.000Z",
"updated_at": "2026-02-22T11:05:00.000Z"
}
],
"schema": [
{
"name": "full_name",
"label": "Full Name",
"type": "text"
},
{
"name": "email",
"label": "Email",
"type": "email"
},
{
"name": "priority",
"label": "Priority",
"type": "select"
}
],
"pagination": {
"has_more": false,
"next_cursor": null
}
}
}{
"success": false,
"error": {
"code": "validation_failed",
"message": "Validation failed",
"details": {}
}
}{
"success": false,
"error": {
"code": "authentication_required",
"message": "Missing or invalid API key",
"details": {}
}
}{
"success": false,
"error": {
"code": "insufficient_scopes",
"message": "API key lacks required scopes for this endpoint",
"details": {}
}
}{
"success": false,
"error": {
"code": "resource_not_found",
"message": "Resource not found",
"details": {}
}
}{
"success": false,
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded",
"details": {}
}
}{
"success": false,
"error": {
"code": "internal_error",
"message": "An internal error occurred",
"details": {}
}
}