---
title: "List account programs"
method: GET
path: "/v1/account_programs"
tags: ["Account Programs"]
---

# List account programs

`GET /v1/account_programs`

## Request

- Base URL: `https://api.augustus.com`
- URL: `https://api.augustus.com/v1/account_programs`
- Auth: HTTP bearer

Lists account programs for the merchant with cursor-based pagination.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Paginated list of account programs

- ListAccountProgramsResponseDto
  - `data` object[], required
    - `id` string, uuid, required: Unique identifier of the account program.
    - `type` 'account_program', required: Resource type discriminator.
    - `label` string, required: Human-readable label for the account program.
    - `status` 'active' | 'frozen', required: Account program lifecycle status. Closed programs are not returned by this endpoint.
    - `created_at` string, date-time, required: ISO 8601 UTC timestamp when the account program was created.
    - `updated_at` string, date-time, required: ISO 8601 UTC timestamp when the account program was last updated.
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required
  - `has_previous` boolean, required
  - `previous_cursor` string, nullable, required

## Changes

- **2026-10-16** `f7ded6c181ab`: 1 info
  - endpoint added
- **2026-04-29** `87ee55c3e7c4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/augustus/apis/ivy-api/changes/v1/account_programs/get.md)

---

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