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

# List advancement requests

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

## Request

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

List advancements requested by merchant. An advancement is the same as a receivable or a prepayment of a receivable. An example of a situation in which a seller might use advancements is if it has a deal with a large customer who it knows is going to take some time to pay its bills. To cover its business expenses in the meantime, the seller could make a deal with a bank to pay it for the goods sold at the time of sale. The seller later repays the bank when it gets paid by its customer. The bank profits because the seller pays a fee for each advancement.

## Path parameters

- `merchantId` integer, required

## Query parameters

- `status` 'PENDING' | 'PROCESSED' | 'ERROR'
- `page` integer
- `perPage` integer

## Headers

- `Authorization` string

## Response `200`

OK

- GETAdvancementRequestsResponse
  - `total_items` integer: Total number of items
  - `per_page` integer: Number of items per page
  - `pages` integer: Number of pages
  - `current_page` integer: Current page number
  - `items` GETAdvancementRequestResponse[]
    - `advancement_request_id` integer: Advancement request ID
    - `date_of_request` string, datetime: The date and time the advancement is requested. Note that the date and time are displayed in UTC format `yyyy-MM-ddThh:mm:ssZ`.
    - `amount_requested` string: Amount requested
    - `begin_date` string: Begin date (DD/MM/YYYY)
    - `end_date` string: End date (DD/MM/YYYY)
    - `advancement_fee` string: Advancement fee for creditor.
    - `discount_rate` string: Advancement discount rate for creditor.
    - `maximum_advancement_percentage` string: Maximum advancement percentage for creditor.
    - `interest_method` 'SIMPLE' | 'COMPOUND' | 'SIMPLIFIED': Advancement interest mode
    - `schedule_payment_date_update_mode` 'KEEP_FUTURE_DATES' | 'UPDATE_TO_NOW': Mode for updating advancement schedule payment date
    - `status` 'PENDING' | 'PROCESSED' | 'ERROR': Advancement status
    - `message` string: Feedback message for advancement request
    - `notify` string: URL that receives notification
    - `advanced_gross_amount` number: Gross amount advanced
    - `advanced_discount_amount` number, float: AdvancementDiscountAmount
    - `advanced_net_amount` number: Net amount advanced
    - `group_transactions` 'TOTAL' | 'NETWORK': Advancement group transactions
    - `initial_transaction_status` 'SCHEDULED' | 'SETTLED': Initial transaction status for advancement

## 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)