Mergify
Mergify's own documented REST API (api.mergify.com) — the live state of a repo's merge queue: active batches, their checks and estimated merge times, and…
Mergify's own documented REST API (api.mergify.com) — the live state of a repo's merge queue: active batches, their checks and estimated merge times, and every pull request still waiting to be batched.
Domain: mergify.com
Also known as: Mergify, mergify, mergify.com, Mergify Merge Queue
Call it directly
bowmark.providers.mergify.queueStatus(args: { owner: string; repo: string }): Promise<mergifyQueueStatus>Functions
| Function | What it does |
|---|---|
queueStatus | The live state of a repo's Mergify merge queue via Mergify's documented REST API — every active batch (status, checks-passed count, estimated merge/CI-finish times, and its pull requests),… |
Types
interface mergifyBatch {
id: string;
name: string;
statusCode: string;
batchFilledSlots: number | null;
maxBatchSlots: number | null;
retries: number;
maxRetries: number;
startedAt: string | null;
estimatedMergeAt: string | null;
estimatedCiFinishAt: string | null;
ciFinishedAt: string | null;
queueRuleName: string;
checksPassed: number;
checksTotal: number;
pullRequestNumbers: number[];
}
interface mergifyQueuedPull {
number: number;
title: string;
url: string;
author: string | null;
queuedAt: string;
priorityRuleName: string | null;
estimatedMergeAt: string | null;
}
interface mergifyQueueStatus {
batches: mergifyBatch[];
waitingPullRequests: mergifyQueuedPull[];
paused: boolean;
pauseReason: string | null;
}Examples
const status = await bowmark.providers.mergify.queueStatus({ owner: "Mergifyio", repo: "mergify-engine" });
// status -> { batches: [{ id: "…", statusCode: "running", checksPassed: 3, checksTotal: 5, … }],
// waitingPullRequests: [{ number: 4821, title: "…", queuedAt: "2026-08-29T…", … }],
// paused: false, pauseReason: null }