Get Roadmap Features
Fetch roadmap features with optional filtering, sorting, and pagination. This endpoint has no user session of its own: call it with an API key holding the `roadmap:read` scope, or from a whitelisted first-party origin. A request with neither is rejected with `401`.
Your personal API key — vw_ followed by 64 hex characters. The same key is also accepted
as Authorization: Bearer vw_....
In: header
Query Parameters
Filter features by status
Value in
- "todo"
- "in-progress"
- "done"
Sort order. recently-completed orders by completion date (nulls last), then by last
update.
"newest"Value in
- "newest"
- "oldest"
- "recently-completed"
Items per page. Values above 50 are rejected with 400.
1 <= value <= 5020Number of items to skip. Mutually redundant with page — page wins if both are sent.
0 <= value01-based page index. An alternative to offset.
1 <= value1Alternative spelling of limit. Takes precedence over limit when both are sent.
1 <= value <= 50Omit one feature from the results — useful for "related features" lists.
1 <= lengthResponse Body
application/json
application/json
curl -X GET "https://example.com/api/v1/roadmap"{ "success": true, "message": "Roadmap features fetched successfully", "data": { "items": [ { "id": "feature_1", "title": "AI Resume Builder", "description": "Generate resumes using AI", "status": "in-progress", "eta": "Q3 2026", "tags": [ "ai", "resume" ], "createdAt": "2026-04-01T00:00:00.000Z", "startedAt": "2026-04-10T00:00:00.000Z", "completedAt": null, "completedQuarter": null, "updatedAt": "2026-04-20T00:00:00.000Z", "timeline": "Started development" } ], "total": 1, "limit": 20, "offset": 0, "page": 1, "pageSize": 20, "totalPages": 1, "hasMore": false, "pagination": { "mode": "offset", "nextOffset": null, "nextCursor": null } }}