---
id: build-list
title: "List builds"
description: "Lists builds for an application."
sidebar_label: "List builds"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/build
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List builds"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/build"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Lists builds for an application.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"query","name":"offset","schema":{"type":"integer","minimum":0,"default":0},"description":"The starting point for pagination. Defaults to 0 if not provided.","example":0},{"in":"query","name":"limit","schema":{"type":"integer"},"description":"The maximum number of results to return per page.","example":30},{"name":"application_id","in":"query","required":true,"schema":{"type":"integer"},"description":"The ID of the application to filter by.","example":234},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["pending","in_progress","failed","successful"]},"description":"The status of the build.","example":"in_progress"},{"name":"commit.id","in":"query","required":false,"schema":{"type":"string"},"description":"The commit ID of the build.","example":"2fa10e1"}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"A list of builds.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["paging","results"],"properties":{"paging":{"type":"object","required":["offset","limit","total"],"properties":{"total":{"type":"integer","description":"The total number of results matching the query.","example":30},"offset":{"type":"integer","minimum":0,"description":"The starting point for pagination. Defaults to 0 if not provided.","example":0},"limit":{"type":"integer","maximum":200,"description":"The maximum number of results to return per page. The maximum allowed value is 200.","example":200}}},"results":{"type":"array","items":{"type":"object","required":["id","branch","commit","created_at","status"],"properties":{"id":{"type":"integer","description":"The ID of the build.","example":123},"application_id":{"type":"integer","description":"The ID of the application that the build belongs to.","example":345},"branch":{"type":"string","description":"The branch that the asset was built from.","example":"main"},"commit":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the commit that the build was built from.","example":"123abc"},"permalink":{"type":"string","description":"The permalink to the commit that the asset was built from.","example":"https://example.com/1234"}}},"created_at":{"type":"string","format":"date-time","description":"The ISO-8601 UTC timestamp of when the build was created.","example":"2021-01-01T00:00:00Z"},"updated_at":{"type":"string","format":"date-time","nullable":true,"description":"The ISO-8601 UTC timestamp of when the build was last updated.","example":"2021-01-02T00:00:00Z"},"description":{"type":"string","nullable":true,"description":"A description of the build.","example":"This is a description of the build."},"nrn":{"type":"string","nullable":true,"description":"The NRN of the build.","example":"organization=1:account=2:namespace=3:application=234:build=123"},"status":{"type":"string","description":"The status of the build.","example":"pending","enum":["pending","in_progress","failed","successful"]}},"title":"buildResponse"}}},"title":"buildListResponse"}}}}},"4XX":{"description":"Client error responses due to invalid input or missing parameters.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific client error (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"bad_request"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Bad Request\", \"Unauthorized\").","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}}}}},"5XX":{"description":"Server error responses indicating an issue on the API side.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific server error (e.g., 500, 502, 503).","example":500},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"internal_server_error"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Internal Server Error\", \"Service Unavailable\").","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred. Please try again later."}}}}}}}}
>
  
</StatusCodes>