1. Resources
  2. /
  3. Changelog
  4. /
  5. REST API job endpoints for large builds

REST API job endpoints for large builds

You can now fetch jobs separately from builds in the REST API, making large matrix or high-parallelism builds easier to query.

List builds without embedded jobs:

GET /v2/organizations/:org/pipelines/:pipeline/builds?exclude_jobs=true

Then fetch only the jobs you need:

# List jobs for one build, with filtering and pagination
GET /v2/organizations/:org/pipelines/:pipeline/builds/:build/jobs?state[]=failed&include_retried_jobs=false&per_page=100

# Fetch one job from a build
GET /v2/organizations/:org/pipelines/:pipeline/builds/:build/jobs/:uuid

# Fetch one job directly by UUID
GET /v2/organizations/:org/jobs/:uuid

Use exclude_jobs=true by default when listing builds unless you need embedded jobs, then use the jobs endpoints for targeted access.

See the REST API jobs documentation for endpoint details and examples.

Buildkite

Atom feed

Start turning complexity into an advantage

Create an account to get started for free.

Buildkite Pipelines

Platform

  1. Pipelines
  2. Public pipelines
  3. Test Engine
  4. Package Registries
  5. Mobile Delivery Cloud
  6. Pricing

Hosting options

  1. Self-hosted agents
  2. Mac hosted agents
  3. Linux hosted agents

Resources

  1. Docs
  2. Blog
  3. Changelog
  4. Example pipelines
  5. Plugins
  6. Webinars
  7. Case studies
  8. Events
  9. Migration Services
  10. CI/CD perspectives

Company

  1. About
  2. Careers
  3. Press
  4. Security
  5. Brand assets
  6. Contact

Solutions

  1. Replace Jenkins
  2. Workflows for MLOps
  3. Testing at scale
  4. Monorepo mojo
  5. Bazel orchestration

Legal

  1. Terms of Service
  2. Acceptable Use Policy
  3. Privacy Policy
  4. Subprocessors
  5. Service Level Agreement
  6. Supplier Code of Conduct
  7. Modern Slavery Statement

Support

  1. System status
  2. Forum
© Buildkite Pty Ltd 2026