# Builds

## Get build status with enriched package metadata

> Retrieves the latest build statuses ordered by commit date, with package metadata enriched from the package collection

```json
{"openapi":"3.0.0","info":{"title":"sfp server","version":"51.3.0"},"security":[{"access-token":[]}],"components":{"securitySchemes":{"access-token":{"scheme":"bearer","bearerFormat":"JWT","type":"http","in":"header"}},"schemas":{"BuildStatusResponseDto":{"type":"object","properties":{"builds":{"description":"List of builds with enriched package metadata","type":"array","items":{"$ref":"#/components/schemas/BuildStatusDto"}},"total":{"type":"number","description":"Total number of builds matching the query"},"hasMore":{"type":"boolean","description":"Whether more results are available"}},"required":["builds","total","hasMore"]},"BuildStatusDto":{"type":"object","properties":{"buildNumber":{"type":"number","description":"Build number"},"commitId":{"type":"string","description":"Commit ID associated with the build"},"status":{"type":"string","description":"Build status","enum":["building","success","failed"]},"buildStartedAt":{"type":"string","description":"When the build started"},"buildCompletedAt":{"type":"string","description":"When the build completed"},"buildError":{"type":"string","description":"Error message if build failed"},"domain":{"type":"string","description":"Domain associated with the build"},"lastUpdatedAt":{"type":"string","description":"Last update timestamp"}},"required":["buildNumber","commitId","status","lastUpdatedAt"]}}},"paths":{"/sfp/api/builds/status":{"get":{"operationId":"BuildsController_getBuildStatus","summary":"Get build status with enriched package metadata","description":"Retrieves the latest build statuses ordered by commit date, with package metadata enriched from the package collection","parameters":[{"name":"repositoryIdentifier","required":true,"in":"query","description":"Repository identifier (e.g., owner/repo)","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","description":"Maximum number of builds to return","schema":{"minimum":1,"maximum":100,"default":20,"type":"number"}},{"name":"offset","required":false,"in":"query","description":"Offset for pagination","schema":{"minimum":0,"default":0,"type":"number"}},{"name":"domain","required":false,"in":"query","description":"Filter by specific domain","schema":{"type":"string"}}],"responses":{"200":{"description":"Build status retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BuildStatusResponseDto"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden - Requires role: member, application"},"500":{"description":"Internal server error"}},"tags":["Builds"]}}}}
```