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

Endpoint

GET /api/v1/{subdomain}/sources
Required ability: sources.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/sources" \
  -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": "Website Form",
        "created_at": "2026-03-01T09:00:00.000000Z",
        "updated_at": "2026-03-01T09:00:00.000000Z"
      },
      {
        "id": 2,
        "tenant_id": 13,
        "name": "Referral",
        "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/sources"
  }
}
See Data Types → Source.
Sources have no color field.

Error responses

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