> ## Documentation Index > Fetch the complete documentation index at: https://developers.criteo.com/llms.txt > Use this file to discover all available pages before exploring further. # /2025-04/retail-media/accounts/{account-id}/balances > Gets page of balance objects for the given account id ## OpenAPI ````yaml https://api.criteo.com/2025-04/retailmedia/open-api-specifications.json get /2025-04/retail-media/accounts/{account-id}/balances openapi: 3.0.1 info: title: Criteo API description: Criteo API - RetailMedia version: 2025-04 servers: - url: https://api.criteo.com security: - oauth: [] tags: - name: Accounts - name: Analytics - name: Audience - name: Balance - name: Campaign - name: Gateway paths: /2025-04/retail-media/accounts/{account-id}/balances: get: tags: - Balance summary: /2025-04/retail-media/accounts/{account-id}/balances description: Gets page of balance objects for the given account id operationId: GetBalancesByAccountId parameters: - name: account-id in: path description: The account to get balances for required: true schema: type: string - name: limitToId in: query description: The ids that you would like to limit your result set to schema: type: array items: type: string - name: pageIndex in: query description: >- The 0 indexed page index you would like to receive given the page size schema: maximum: 2147483647 minimum: 0 type: integer format: int32 default: 0 - name: pageSize in: query description: >- The maximum number of items you would like to receive in this request schema: maximum: 2147483647 minimum: 1 type: integer format: int32 default: 25 responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/BalanceResponseV2PagedListResponse' security: - oauth: - RetailMedia_Balance_Read components: schemas: BalanceResponseV2PagedListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/ResourceOfBalanceResponseV2' errors: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true metadata: $ref: '#/components/schemas/PageMetadata' warnings: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true description: Data model for a paged list of response resources ResourceOfBalanceResponseV2: type: object properties: attributes: $ref: '#/components/schemas/BalanceResponseV2' id: type: string description: Id of the entity nullable: true type: type: string description: Canonical type name of the entity nullable: true description: A class that represents a domain entity exposed by an API nullable: true CommonProblem: type: object properties: code: type: string description: A machine-readable error code, expressed as a string value. nullable: true detail: type: string description: >- A human-readable explanation specific to this occurrence of the problem nullable: true instance: type: string description: A URI that identifies the specific occurrence of the problem. nullable: true source: type: object additionalProperties: type: string description: >- A machine-readable structure to reference to the exact location(s) causing the error(s) nullable: true stackTrace: type: string nullable: true title: type: string description: A short human-readable description of the problem type nullable: true traceId: type: string description: The request correlation ID this problem comes from. nullable: true traceIdentifier: type: string description: >- The request correlation ID this problem comes from. (deprecated, use traceId instead) nullable: true type: enum: - unknown - access-control - authentication - authorization - availability - deprecation - quota - validation type: string description: The problem's category. nullable: true description: Common problem object. PageMetadata: required: - currentPageIndex - currentPageSize type: object properties: currentPageIndex: type: integer format: int32 currentPageSize: type: integer format: int32 nextPage: type: string nullable: true previousPage: type: string nullable: true totalItemsAcrossAllPages: type: integer format: int64 nullable: true totalPages: type: integer format: int64 nullable: true additionalProperties: false description: Metadata related to the current request BalanceResponseV2: required: - name - startDate - balanceType - spendType - privateMarketBillingType type: object properties: balanceType: enum: - unknown - capped - uncapped type: string description: Type of the balance. createdAt: type: string description: Creation time of the balance. format: date-time deposited: type: number description: Amount of billable funds allotted to the balance. format: double nullable: true endDate: type: string description: End date of the balance in the format YYYY-MM-DD. nullable: true memo: type: string description: Memo. nullable: true name: type: string description: Name of the balance. poNumber: type: string description: Purchase Order number. nullable: true privateMarketBillingType: enum: - notApplicable - billByRetailer - billByCriteo - unknown type: string description: Billing type for Private Market of the balance. remaining: type: number description: Amount of remaining funds of the balance. format: double nullable: true spendType: enum: - Onsite - Offsite - OffsiteAwareness type: string description: Spend Type of the balance. spent: type: number description: Amount of spent funds of the balance. format: double nullable: true startDate: type: string description: Start date of the balance in the format YYYY-MM-DD. status: enum: - unknown - scheduled - active - ended type: string description: Status of the balance. updatedAt: type: string description: Update time of the balance. format: date-time description: >- A Retail Media Balance used to determine the funds available for any or all campaigns in an account nullable: true securitySchemes: oauth: type: oauth2 flows: clientCredentials: tokenUrl: https://api.criteo.com/oauth2/token scopes: {} authorizationCode: authorizationUrl: https://api.criteo.com/oauth2 tokenUrl: https://api.criteo.com/oauth2/token scopes: {} ````