---
title: "Get account buckets"
method: GET
path: "/v1/buckets"
tags: ["Buckets"]
---

# Get account buckets

`GET /v1/buckets`

## Request

- Base URL: `https://sandbox.pismolabs.io/accounting`
- URL: `https://sandbox.pismolabs.io/accounting/v1/buckets`
- Auth: HTTP bearer

Get one or all buckets for a specific tenant. Buckets are accumulators that are related to an accounting script. Buckets can have their values changed with each related accounting entry.

## Query parameters

- `pageSize` integer
- `pageOffset` integer
- `accountId` integer
- `name` string

## Response `200`

OK

- object
  - `has_next` boolean: Indicates if there are more items to be retrieved.
  - `items` object[]: Items retrieved from a given request.
    - `name` string: Bucket name
    - `account` integer: Account ID
    - `value` number: Bucket value
    - `updated_at` string, date: Bucket last updated date

## Other responses

- `400`: Bad request

---

[API](https://skmtc.dev/pismo/apis/core-platform-accounting.md) - [All operations](https://skmtc.dev/pismo/apis/core-platform-accounting/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/core-platform-accounting/revisions/fdb645c3e65c?raw)