WARNING: There are some fields exposed on the Google Cloud Console that aren't available on this API. When reading from the API, you will not see these fields in the return value, though they may have been set in the Cloud Console.
HTTP request
GET https://billingbudgets.googleapis.com/v1beta1/{parent=billingAccounts/*}/budgets
Required. Name of billing account to list budgets under. Values are of the form billingAccounts/{billingAccountId}.
Authorization requires the following IAM permission on the specified resource parent:
billing.budgets.list
Query parameters
Parameters
scope
string
Optional. Set the scope of the budgets to be returned, in the format of the resource name. The scope of a budget is the cost that it tracks, such as costs for a single project, or the costs for all projects in a folder. Only project scope (in the format of "projects/project-id" or "projects/123") is supported in this field. When this field is set to a project's resource name, the budgets returned are tracking the costs for that project.
pageSize
integer
Optional. The maximum number of budgets to return per page. The default and maximum value are 100.
pageToken
string
Optional. The value returned by the last ListBudgetsResponse which indicates that this is a continuation of a prior budgets.list call, and that the system should return the next page of data.
Request body
The request body must be empty.
Response body
Response for budgets.list
If successful, the response body contains data with the following structure:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-05-14 UTC."],[[["\u003cp\u003eThis API endpoint retrieves a list of budgets associated with a specified billing account, using the \u003ccode\u003ebillingAccounts/{billingAccountId}\u003c/code\u003e format.\u003c/p\u003e\n"],["\u003cp\u003eThe request is a \u003ccode\u003eGET\u003c/code\u003e request that uses gRPC Transcoding, and the request body must be empty.\u003c/p\u003e\n"],["\u003cp\u003eYou can filter the budgets returned by setting the \u003ccode\u003escope\u003c/code\u003e parameter, which currently only supports project-level filtering, in the \u003ccode\u003eprojects/project-id\u003c/code\u003e format.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides a list of budgets, along with a \u003ccode\u003enextPageToken\u003c/code\u003e if additional pages of budgets are available, and requires \u003ccode\u003ebilling.budgets.list\u003c/code\u003e IAM permission on the specified billing account.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this API requires either the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-billing\u003c/code\u003e OAuth scopes.\u003c/p\u003e\n"]]],[],null,["# Method: billingAccounts.budgets.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListBudgetsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns a list of budgets for a billing account.\n\nWARNING: There are some fields exposed on the Google Cloud Console that aren't available on this API. When reading from the API, you will not see these fields in the return value, though they may have been set in the Cloud Console.\n\n### HTTP request\n\n`GET https://billingbudgets.googleapis.com/v1beta1/{parent=billingAccounts/*}/budgets`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for budgets.list\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `https://www.googleapis.com/auth/cloud-billing`"]]