---
title: "Get S3 Vesting Schedule"
method: GET
path: "/api/v1/ledger/s3/vesting-schedule"
tags: ["User APIs", "ledger-platform"]
---

# Get S3 Vesting Schedule

`GET /api/v1/ledger/s3/vesting-schedule`

One row per grant: award date, status, progress, and the next vest.

## Response `200`

Successful Response

- S3GrantBalanceRow[]
  - `grant_id` string, uuid, required
  - `client_id` string, uuid, nullable
  - `order_id` string, required
  - `award_date` string, date-time, nullable
  - `status` string, required
  - `vesting_kind` string, required
  - `block_contract_id` string, uuid, nullable
  - `block_request_id` string, uuid, nullable
  - `auto_apply` boolean
  - `allocated` string, required
  - `accrued` string, required
  - `consumed` string, required
  - `adjusted` string
  - `available` string, required
  - `periods_total` integer, required
  - `periods_issued` integer, required
  - `progress_pct` integer, required
  - `next_vest_at` string, date-time, nullable
  - `next_vest_amount` string, nullable

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)