ioZen Docs
API ReferenceIntake Bots
GET
/intake-bots

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication. Pass your ioZen API key as a Bearer token in the Authorization header.

In: header

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"
{
  "success": true,
  "data": {
    "intake_bots": [
      {
        "id": "cm7abc12x0001yz9k8mno3pqr",
        "name": "Customer Onboarding",
        "status": "ACTIVE",
        "submission_count": 142,
        "created_at": "2026-01-15T10:30:00.000Z",
        "updated_at": "2026-02-20T14:22:00.000Z"
      },
      {
        "id": "cm7xyz89w0002yz9k8mno3pqr",
        "name": "Support Ticket",
        "status": "ACTIVE",
        "submission_count": 57,
        "created_at": "2026-02-01T09:00:00.000Z",
        "updated_at": "2026-02-24T18:45:00.000Z"
      }
    ],
    "pagination": {
      "has_more": true,
      "next_cursor": "cm7xyz89w0002yz9k8mno3pqr"
    }
  }
}
{
  "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": {}
  }
}