---
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","description":"The number of results returned per page. Defaults to 30.","example":30}}},"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>