list-pulls

List pulls targeting a repo

Auth

Authenticated

Examples

pearing-cli list-pulls website --status open --page 1 --per-page 50
pearing-cli list-pulls teams/platform/website --target-ref main
pearing-cli list-pulls website --created-by alice --status open
pearing-cli list-pulls website --merged-by bob

Expected Response

Prints a paginated JSON response from the API. Each pull includes source_repo so you can tell which repo the source branch belongs to.

Errors

  • 404 Not Found when the referenced resource does not exist.
  • 403 Forbidden when owner/repo access checks fail.

Common auth errors are documented on the CLI overview page.

Help Output

List pulls targeting a repo.

Returns paginated pulls. All filters are AND'd together.

Usage: pearing-cli list-pulls [OPTIONS] <REPO>

Arguments:
  <REPO>  Target repo locator (`teams/<team_slug>/<repo_slug>` or `<username>/<repo_slug>`), or `<repo_slug>` for authenticated user

Options:
      --page <PAGE>              Page number (1-based)
      --per-page <PER_PAGE>      Results per page
      --status <STATUS>          Filter by pull status [possible values: open, draft, closed, merged]
      --target-ref <TARGET_REF>  Filter by target branch
      --created-by <CREATED_BY>  Filter by creator username (case-insensitive)
      --merged-by <MERGED_BY>    Filter by merger username (case-insensitive)
      --closed-by <CLOSED_BY>    Filter by closer username (case-insensitive)
  -h, --help                     Print help (see more with '--help')