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

# List of rewards

`POST /spacemesh.v2alpha1.RewardService/List`

## Request

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

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

## Request body

- Spacemeshv2alpha1RewardRequest
  - `coinbase` string
  - `endLayer` integer
  - `limit` string, uint64
  - `offset` string, uint64
  - `smesher` string, byte
  - `sortOrder` 'ASC' | 'DESC'
  - `startLayer` integer

## Response `200`

A successful response.

- Spacemeshv2alpha1RewardList
  - `rewards` Spacemeshv2alpha1Reward[]
    - `coinbase` string
    - `layer` integer
    - `layerReward` string, uint64
    - `smesher` string, byte
    - `total` string, uint64

## 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)