---
title: "List of accounts"
method: POST
path: "/spacemesh.v2alpha1.AccountService/List"
tags: ["AccountService"]
---

# List of accounts

`POST /spacemesh.v2alpha1.AccountService/List`

## Request

- Base URL: `https://testnet-api.spacemesh.network`
- URL: `https://testnet-api.spacemesh.network/spacemesh.v2alpha1.AccountService/List`
- Auth: none declared
- TypeScript: <https://skmtc.dev/spacemesh/apis/spacemesh-api/docs/spacemesh.v2alpha1.AccountService/List/post.ts> (a function with typed inputs; its response is checked against the schema)

List is a method that takes an "AccountRequest" body and returns an "AccountList".
This method is used to retrieve a list of accounts based on the provided request parameters.

## Request body

- Spacemeshv2alpha1AccountRequest
  - `addresses` string[]
  - `limit` string, uint64
  - `offset` string, uint64

## Response `200`

A successful response.

- Spacemeshv2alpha1AccountList
  - `accounts` Spacemeshv2alpha1Account[]
    - `address` string
    - `current` Spacemeshv2alpha1AccountState
      - `balance` string, uint64
      - `counter` string, uint64
      - `layer` integer
    - `projected` Spacemeshv2alpha1AccountState
      - `balance` string, uint64
      - `counter` string, uint64
      - `layer` integer
    - `template` string

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/spacemesh/apis/spacemesh-api.md) - [All operations](https://skmtc.dev/spacemesh/apis/spacemesh-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spacemesh/apis/spacemesh-api/revisions/427c8b53574b?raw)