---
title: "List advancements for merchant (outdated)"
method: GET
path: "/v1/merchants/{merchantId}/advancements"
tags: ["Merchant advancement"]
---

# List advancements for merchant (outdated)

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

## Request

- Base URL: `https://sandbox.pismolabs.io/merchants`
- URL: `https://sandbox.pismolabs.io/merchants/v1/merchants/{merchantId}/advancements`
- Auth: HTTP bearer

List advancements for merchant by merchant ID. A merchant advancement is sometimes called a prepayment of receivables. You arrange to have a financial
institution make regular deposits into your account equal to what you expect to receive in the future from credit card sales in installments or post-dated
checks and bills. The financial institution deducts its fee before it puts the money in your account. You pay back each deposit when you receive
payment from your customers. This is a way of covering business expenses in the short term. It's a cheaper alternative to a loan.

(<strong>Outdated:</strong> For an updated version of the future merchant schedule refer to [List Transactions](https://developers.pismo.io/pismo-docs/reference/merchants-transactions).)

## Path parameters

- `merchantId` integer, required

## Query parameters

- `date` string, date
- `startPaymentDate` string, date
- `endPaymentDate` string, date

## Headers

- `Authorization` string

## Response `200`

OK

- GETAdvancementResponse
  - `items` object[]
    - `payment_date` string, date: Scheduled payment date. Format = yyyy-mm-dd.
    - `gross_value` number, float: Gross amount
    - `discount` number, float: Discount amount
    - `net_value` number, float: Net amount
    - `max_advancement_amount` number, float: Maximum advancement amount
    - `advancement_discount_amount` number, float: AdvancementDiscountAmount
    - `advancement_amount` number, float: Advancement amount
  - `totals` object
    - `gross_value` number, float: Gross amount
    - `discount` number, float: Discount amount
    - `net_value` number, float: Net amount
    - `max_advancement_amount` number, float: Maximum advancement amount
    - `advancement_discount_amount` number, float: AdvancementDiscountAmount
    - `advancement_amount` number, float: Advancement amount

## Other responses

- `400`: Bad Request
- `401`: Access token is missing or invalid
- `500`: Internal server error

---

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