Pagination

The only paginated operation is GET /projects. Reference lists (/areas, /preferences, /project-preferences, /companies) and GET /projects/list return everything in one response.

limit and offset

GET /projects uses offset pagination. limit is the page size — 20 by default, minimum 1; values above 100 are capped at 100. offset is the number of projects to skip, 0 by default. The response contains total, the number of projects matching the filters regardless of pagination, and items, the current page.

# Third page of 20
curl -G https://agent-dev.azizdubai.com/projects \
  -H "X-API-Key: $AZIZ_API_KEY" \
  --data-urlencode "limit=20" \
  --data-urlencode "offset=40"

{ "status": "success", "data": { "total": 137, "items": [ ] } }

Keep the same filters on every page request and stop when offset + items.length >= total. Use total to render page numbers — Math.ceil(total / limit) pages.

Flat list: GET /projects/list

When you need every published project at once — for example, to populate a “Project” dropdown — use GET /projects/list. It returns id, name and a logo (the project’s first image) for each project, sorted by name, and is neither paginated nor filterable.

curl https://agent-dev.azizdubai.com/projects/list -H "X-API-Key: $AZIZ_API_KEY"