Skip to main content
Returns a Laravel-paginated list of statuses.

​
Endpoint

GET /api/v1/{subdomain}/statuses
Required ability: statuses.read.

​
Headers

HeaderValue
AuthorizationBearer apitk_...
Acceptapplication/json

​
Path parameters

​
subdomain
string
required
Your workspace subdomain.

​
Query parameters

​
page
integer
1-indexed page number. Defaults to 1.
​
per_page
integer
Items per page. Defaults to 15, maximum 100.

​
Example request

curl "https://dash.xobito.com/api/v1/acme/statuses" \
  -H "Authorization: Bearer apitk_your_token_here" \
  -H "Accept: application/json"

​
Example response

200 OK
{
  "status": "success",
  "data": {
    "current_page": 1,
    "data": [
      {
        "id": 1,
        "tenant_id": 13,
        "name": "New Lead",
        "color": "#3B82F6",
        "isdefault": 1,
        "created_at": "2026-03-01T09:00:00.000000Z",
        "updated_at": "2026-03-01T09:00:00.000000Z"
      },
      {
        "id": 2,
        "tenant_id": 13,
        "name": "Qualified",
        "color": "#22C55E",
        "isdefault": 0,
        "created_at": "2026-03-01T09:05:00.000000Z",
        "updated_at": "2026-03-01T09:05:00.000000Z"
      }
    ],
    "per_page": 15,
    "total": 2,
    "last_page": 1,
    "from": 1,
    "to": 2,
    "path": "https://dash.xobito.com/api/v1/acme/statuses"
  }
}
See Data Types → Status.

​
Error responses

StatusWhenBody
401Missing / invalid token{"status":"error","message":"Invalid API token"}
403Missing ability{"status":"error","message":"Token does not have the required ability: statuses.read"}
429Rate limit{"message":"Too many requests","retry_after":45}
500Server error{"status":"error","message":"Failed to list statuses"}