API Reference

GET List Jobs

v1Updated 2026-03-07

Get jobs

Scopesjobs:read / jobs:write

GET/api/v1/public/:tenant_slug/jobs

Name	Type	Required	Description
tenant_slug	string	yes	Tenant slug in path.
page	integer	no	Default `1`.
per_page	integer	no	Default `25`, max `200`.
sort	string	no	Example: `-updated_at`.
filter[status]	string	no	Filter by status.
filter[q]	string	no	Name search.

Request


curl -H "Authorization: Bearer <API_KEY>" \
  "http://localhost:3333/api/v1/public/agado-ats/jobs?page=1&per_page=20&sort=-updated_at"

200 Response


{
  "data": [{ "id": 102, "name": "Senior Backend Engineer", "status": "published" }],
  "meta": { "page": 1, "per_page": 20, "total": 1, "total_pages": 1 }
}

400 Response


{
  "error": {
    "code": "bad_request",
    "message": "Validation failed for request payload",
    "request_id": "req_123"
  }
}

401 Response


{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key",
    "request_id": "req_401"
  }
}

403 Response


{
  "error": {
    "code": "forbidden",
    "message": "API key does not have required scope",
    "request_id": "req_403"
  }
}

404 Response


{
  "error": {
    "code": "not_found",
    "message": "Resource was not found",
    "request_id": "req_404"
  }
}

500 Response


{
  "error": {
    "code": "internal_error",
    "message": "Unexpected server error",
    "request_id": "req_500"
  }
}

See Error code catalog.