---
title: "List all proposals of an account"
method: GET
path: "/accounts/{account_id}/purchase_proposals"
tags: ["Accounts"]
---

# List all proposals of an account

`GET /accounts/{account_id}/purchase_proposals`

## Request

- Base URL: `https://api.togai.com`
- URL: `https://api.togai.com/accounts/{account_id}/purchase_proposals`
- Auth: HTTP bearer

List all proposals of an account

## Path parameters

- `account_id` string, required

## Response `200`

Response for list proposals of an account request

- ProposalsPaginatedResponse
  - `data` ProposalsListResponse[]
    - `id` string, required
    - `pricePlanId` string
    - `pricePlanName` string
    - `pricePlanVersion` integer
    - `status` 'SUCCESS' | 'FAILURE' | 'PENDING' | 'IN_PROGRESS' | 'PROPOSAL_ACTIVE' | 'PROPOSAL_APPROVED' | 'PROPOSAL_DECLINED' | 'PROPOSAL_EXPIRED', required: Status of the purchase
    - `walletTopupDetails` WalletTopupDetails: Information related to wallet topup purchase
      - `purchaseAmount` number: Specifies the amount to be paid to top up wallet with the specified top up amount. If left null, purchase amount will be same as top up amount
      - `topupAmount` number, required: Specifies the value to be topped up in the wallet
    - `idempotencyKey` string
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `expiryDate` string, date-time
    - `paymentMode` 'PREPAID' | 'POSTPAID', required
    - `type` 'ENTITLEMENT_GRANT' | 'ASSOCIATION' | 'WALLET_TOPUP' | 'PREPAID', required: Specifies whether this purchase is for granting entitlements or for an association or for wallet topup or prepaid purchase. If left null, ENTITLEMENT_GRANT is taken as default
  - `nextToken` string
  - `context` PaginationOptions
    - `pageSize` integer
    - `sortOrder` 'ASC' | 'DESC'

## Other responses

- `400`: Error response
- `401`: Error response
- `403`: Error response
- `404`: Error response
- `429`: Error response
- `default`: Error response

## Changes

- **2024-03-11** `cc0b10fb537e`: 1 warning
  - added the new `PREPAID` enum value to the `data/items/type` response property for the response status `200`
- **2024-03-01** `6fb940b0dad9`: 3 breaking, 1 warning, 2 info
  - the response property `data/items/pricePlanId` became optional for the status `200`
  - the response property `data/items/pricePlanName` became optional for the status `200`
  - the response property `data/items/pricePlanVersion` became optional for the status `200`
  - added the new `WALLET_TOPUP` enum value to the `data/items/type` response property for the response status `200`
  - …2 more
- **2023-11-03** `a6c96c5ec06e`: 1 warning
  - added the new `IN_PROGRESS` enum value to the `data/items/status` response property for the response status `200`
- **2023-09-02** `6b13f6f47735`: 2 warning, 6 info
  - removed the optional property `data/items/idempotencyKey` from the response with the `200` status
  - removed the optional property `data/items/walletTopupDetails` from the response with the `200` status
  - the response property `data/items/pricePlanId` became required for the status `200`
  - the response property `data/items/pricePlanName` became required for the status `200`
  - …4 more

[Operation history](https://skmtc.dev/togaihq/apis/togai-apis/changes/accounts/:account_id/purchase_proposals/get.md)

---

[API](https://skmtc.dev/togaihq/apis/togai-apis.md) - [All operations](https://skmtc.dev/togaihq/apis/togai-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/togaihq/apis/togai-apis/revisions/442f5d8f4aa0?raw)