/projects
Two filters are applied in the query itself, not to the page afterwards — so the total is what the caller can actually page through:
- Projects in Bidding or Hold are excluded entirely.
- A project's optional per-vendor allow-list is honoured: a project whose
vendorIdsis blank is visible to everyone, one that names vendors is visible only to those named.
clientId, projectManagerId, salesManagerId and the panel-targeting filters are deliberately not exposed — they are staff- and client-side search axes, and filtering by clientId would be asking about a client the vendor is not told about anyway.
https://dashboard.a2bsample.com/api/developer/playground/vendor/projectsAuthorizationandX-Api-Tokenas headers./projectshttps://dashboard.a2bsample.com/api/developer/playground/vendor/projectsSend a request to see the response.
Example request
Request
Headers3
AuthorizationstringrequiredThe secret half. A vendor token starts vnd_ — the four-character prefix says which table to resolve it in, so the row it matches is the caller. A clt_… token on this prefix is a 403, not a 404.
X-Api-TokenstringrequiredThe identity half — this vendor's own 40-hex apiToken, the value GET /api/developer/me echoes back. Compared in constant time against the bearer token's own row, so a bearer token lifted on its own is not enough to call the playground.
AcceptstringoptionalResponse media type.
Query parameters5
pageNointegeroptionalPage number, 1-based. A null or non-positive value means the first page.
maxPerPageintegeroptionalRows per page. Nothing is rejected for being out of range — a null or non-positive size means the default and an oversized one is clamped. The clamp is never silent: the listing still answers with the real total. (max 200)
projectNamestringoptionalName contains — substring match.
statusintegeroptionalProjectStatus code. Bidding (1) and Hold (4) are legal values that match nothing here — they are excluded in the query itself.
countryIdstring<uuid>optionalTarget country.
Responses
Matching projects plus the pageable total.
successboolean- Whether the call succeeded.
projectsarray<object>totalinteger- Rows matching the filter, ignoring paging.