---
title: "Query Freight"
method: GET
path: "/v1beta1/projects/{project}/freight"
tags: ["Core", "Project-Level"]
---

# Query Freight

`GET /v1beta1/projects/{project}/freight`

Query and filter Freight resources from a project's namespace.

## Path parameters

- `project` string, required

## Query parameters

- `stage` string
- `origins` string[]
- `group` string
- `groupBy` string
- `orderBy` string
- `reverse` boolean

## Response `200`

OK

- PkgServerQueryFreightsResponse
  - `groups` object
  - `resourceVersion` string — ResourceVersion is the Kubernetes list resourceVersion clients use to seed a follow-up Freight watch so the API server does not replay every existing Freight as an ADDED event. It is empty for the stage-scoped query, whose result is assembled from multiple sources rather than a single watchable namespace list.

---

[API](https://skmtc.net/akuity/apis/kargo-api.md) · [All operations](https://skmtc.net/akuity/apis/kargo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/akuity/kargo-api/versions/132dee1064a1/schema)