List recommendations

A paginated list of recommendations. Filter by lifecycle state. State-filtered pages fill from bounded batches, so keep paging until the cursor is null.

GET/v1/recommendations

Example

curl -X GET "https://example.com/v1/recommendations" \  -H "Authorization: Bearer $ASKENGINE_API_KEY"

Query Parameters

state?string

Filter by lifecycle state. Omitted: everything except archived.

Valuesopen, accepted, dismissed, shipped, validated, stale, archived

limit?integer

Maximum number of results to return.

Default20Range1-50

cursor?string

Pagination cursor from the previous response.

Response

{  "data": [    {      "recommendationId": "rec_456",      "title": "Add an inline setup checklist",      "lifecycleState": "accepted",      "confidence": "strong",      "signalIds": [        "sig_123"      ],      "generatedAt": 1764690000000    }  ],  "cursor": null}