---
title: "Get a list of ingest budgets."
method: GET
path: "/v2/ingestBudgets"
tags: ["ingestBudgetManagementV2"]
---

# Get a list of ingest budgets.

`GET /v2/ingestBudgets`

Get a list of all ingest budgets. The response is paginated with a default limit of 100 budgets per page.

## Query parameters

- `limit` integer
- `token` string

## Response `200`

A paginated list of budgets.

- ListIngestBudgetsResponseV2
  - `data` IngestBudgetV2[], required — List of ingest budgets.
    - `name` string, required — Display name of the ingest budget.
    - `scope` string, required — A scope is a constraint that will be used to identify the messages on which budget needs to be applied. A scope is consists of key and value separated by =. The field must be enabled in the fields table. Value supports wildcard. e.g. _sourceCategory=*prod*payment*, cluster=kafka. If the scope is defined _sourceCategory=*nginx* in this budget will be applied on messages having fields _sourceCategory=prod/nginx, _sourceCategory=dev/nginx, or _sourceCategory=dev/nginx/error
    - `capacityBytes` integer, required — Capacity of the ingest budget, in bytes. It takes a few minutes for Collectors to stop collecting when capacity is reached. We recommend setting a soft limit that is lower than your needed hard limit. The capacity bytes unit varies based on the budgetType field. For `dailyVolume` budgetType the capacity specified is in bytes/day whereas for `minuteVolume` budgetType its bytes/min.
    - `timezone` string — Time zone of the reset time for the ingest budget. Follow the format in the [IANA Time Zone Database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List).
    - `resetTime` string — Reset time of the ingest budget in HH:MM format.
    - `description` string — Description of the ingest budget.
    - `action` string, required — Action to take when ingest budget's capacity is reached. All actions are audited. Supported values are: * `stopCollecting` * `keepCollecting`
    - `auditThreshold` integer — The threshold as a percentage of when an ingest budget's capacity usage is logged in the Audit Index.
    - `id` string, required — Unique identifier for the ingest budget.
    - `usageBytes` integer — Current usage since the last reset, in bytes.
    - `usageStatus` string — Status of the current usage. Can be `Normal`, `Approaching`, `Exceeded`, or `Unknown` (unable to retrieve usage).
    - `createdAt` string, date-time, required — The creation timestamp in UTC of the Ingest Budget.
    - `createdBy` string, required — The identifier of the user who created the Ingest Budget.
    - `modifiedAt` string, date-time, required — The modified timestamp in UTC of the Ingest Budget.
    - `modifiedBy` string, required — The identifier of the user who modified the Ingest Budget.
    - `budgetVersion` integer — The version of the Ingest Budget
  - `next` string — Next continuation token.

## Other responses

- `default` — Operation failed with an error.

---

[API](https://skmtc.net/sumologic/apis/sumo-logic-api.md) · [All operations](https://skmtc.net/sumologic/apis/sumo-logic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sumologic/sumo-logic-api/revisions/18a824df1e78/schema)