List queue-entry state history for several pull requests
Returns up to 50 pull requests’ complete queue-entry timelines in one response — the batch form of GET /v2/pull-requests/{id}/queue-entry-history, and the equivalent of v1’s getSubmittedPullRequests with includeTimeline.
limit counts pull requests, not transitions, and every group carries that pull request’s whole timeline (oldest-first by default; send direction=newest for v1’s includeTimeline order), so one call answers for the whole set and each group is complete on arrival. A page’s byte size therefore follows the data rather than a fixed row count: for a pull request with an exceptionally long timeline, page within it using the single-pull-request endpoint instead.
An id naming a pull request in another organization, or one that was never enqueued, comes back as an empty group rather than an error — this route never 404s, so diff the ids you asked for against the groups you got.
Authorizations
An API key, sent as Authorization: Bearer <key>. An organization admin creates one in the Trunk app under Settings → Developer → API Keys and chooses the permissions it holds. A new key starts with no permissions: it can read merge queues but change nothing in them, and it cannot get a Dynamic CI plan. Each endpoint that needs a permission names it in its description; the Dynamic CI plan endpoints need Generate Dynamic CI plans.
Query Parameters
Comma-separated pull request ids, at most 50 — v1's own batch ceiling. A member that is not a uuid is a 400 naming it; a repeated id is read once. Ids are normalized to lowercase in the response (and for paging), so diff against the lowercased set you asked for.
"6f1d2c3b-4a59-4e6f-8a7b-9c0d1e2f3a4b,7a2e3d4c-5b60-4f71-9b8c-0d1e2f3a4b5c"
Response
A page of pull requests, each with its timeline