---
title: "List merchant advancement requests"
method: GET
path: "/v2/merchants/{merchantId}/advancements"
tags: ["Merchant advancement"]
---

# List merchant advancement requests

`GET /v2/merchants/{merchantId}/advancements`

## Request

- Base URL: `https://sandbox.pismolabs.io/merchants`
- URL: `https://sandbox.pismolabs.io/merchants/v2/merchants/{merchantId}/advancements`
- Auth: none declared

List advancement requests for a merchant, with optional filters by status and date ranges, plus pagination and sorting.

**Date filters.** `beginDateFrom`, `beginDateTo`, `requestDateFrom`, `requestDateTo` accept `YYYY-MM-DD`. The `*From` filters match advancements on or after the given date; the `*To` filters match advancements on or before it.

**Pagination and sorting.** `page` defaults to 1 and `perPage` defaults to 10; `0` is treated as the default for both. `perPage` accepts up to 100. `order` accepts `asc` or `desc`. `orderBy` accepts `request_date`, `begin_date`, `end_date`, `status`, or `advancement_request_id`; any other value is treated as `request_date`. The default sort is `request_date DESC`.

## Path parameters

- `merchantId` integer, required: Merchant ID

## Query parameters

- `status` 'PENDING' | 'PROCESSED' | 'ERROR'
- `beginDateFrom` string, date
- `beginDateTo` string, date
- `requestDateFrom` string, date
- `requestDateTo` string, date
- `page` integer
- `perPage` integer
- `order` 'asc' | 'desc'
- `orderBy` string

## Response `200`

OK

- AdvancementListResponse: Paginated list of advancement requests for a merchant.
  - `page` integer, required: 1-based page number of the current response.
  - `per_page` integer, required: Items per page applied to the current response.
  - `has_next` boolean, required: True when at least one more page exists after this one.
  - `items` AdvancementListItem[], required: Advancement request items in the current page. May be empty.
    - `advancement_request_id` integer, required: Advancement request identifier.
    - `begin_date` string, date, required: Start of the advancement period in ISO 8601 (UTC). Format = `YYYY-MM-DD`.
    - `end_date` string, date, nullable, required: End of the advancement period in ISO 8601 (UTC). Format = `YYYY-MM-DD`. When not provided, set to `null`.
    - `request_date` string, date, required: Advancement request submission date in ISO 8601 (UTC). Format = `YYYY-MM-DD`.
    - `status` 'PENDING' | 'PROCESSED' | 'ERROR', required: Current advancement status.
    - `real_time_settlement` boolean, required: Is the advancement settled in real time?
    - `interest_method` 'SIMPLE' | 'COMPOUND' | 'SIMPLIFIED', required: Interest calculation method applied to the advancement.
    - `advancement_gross_amount` number, nullable, required: Gross amount of the advancement; `null` while the advancement is not yet processed.
    - `advancement_net_amount` number, nullable, required: Net amount of the advancement; `null` while the advancement is not yet processed.
    - `advancement_discount_amount` number, nullable, required: Total discount applied to the advancement; `null` while the advancement is not yet processed.
    - `error_message` string, nullable, required: Error message; `null` when status is `PENDING` or `PROCESSED`.
    - `currency_code` string, nullable: ISO 4217 alphanumeric currency code. When you do not want to record a transaction's currency code, use `null`.

## Other responses

- `400`: BAD REQUEST — invalid `status`; invalid date filter (must be `YYYY-MM-DD`); inverted date range; `perPage > 100`; negative `page`/`perPage`; `order` outside `asc/desc`.
- `404`: Merchant does not belong to the tenant.

---

[API](https://skmtc.dev/pismo/apis/seller-management-merchant-advancements.md) - [All operations](https://skmtc.dev/pismo/apis/seller-management-merchant-advancements/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/seller-management-merchant-advancements/revisions/3cb3ff54cef7?raw)