VUZDevelopers

Get all projects with filtering

GET
/projects

Retrieves a paginated list of projects with comprehensive filtering options.

Filtering Options:

  • status: Filter by one or more statuses
  • priority: Filter by priority levels
  • clientId: Filter by linked client
  • category: Filter by category
  • tags: Filter by tags (any match)
  • search: Search in name and description
  • includeDeleted: Include soft-deleted projects

Pagination:

  • page: Page number (default: 1)
  • limit: Items per page (default: 20)
  • sortBy: Sort field (name, status, createdAt, startDate, etc.)
  • sortOrder: ASC or DESC

Authorization

X-Api-Key<token>

Business API key, e.g. vuz_ab12cdef... Created via Settings → Integrations → API Keys. Unlike partner keys, a public API key's STRING does not encode its environment — isolation instead comes from a completely separate sandbox database: a key minted on the Sandbox server (above) only ever reads/writes sandbox data and can never see or affect production, regardless of what the key looks like.

In: header

Query Parameters

page?number

Page number (1-indexed)

Range1 <= value
Default1
limit?number

Items per page

Range1 <= value <= 100
Default20
sort?string

Sort by field(s). Format: "field:asc" or "field:desc". Multiple: "field1:asc,field2:desc"

q?string

Free-text search query

status?array<>
priority?array<>
clientId?string

Filter by client

category?string

Filter by category

tags?array<string>

Filter by tags (any match)

search?string

Search in name and description

includeDeleted?boolean

Include deleted projects

sortBy?string

Sort field

Default"createdAt"
sortOrder?string

Sort order

Default"DESC"

Response Body

application/json

curl -X GET "https://example.com/projects"
{  "items": [    {      "id": "string",      "name": "string",      "status": "draft",      "priority": "low",      "clientName": "string",      "startDate": "string",      "endDate": "string",      "estimatedValue": "string",      "actualValue": "string",      "currency": "string",      "documentsCount": 0,      "createdAt": "2019-08-24T14:15:22Z"    }  ],  "total": 0,  "page": 0,  "limit": 0}