# Payout List

How to get your payout detail list.

# Post

https://sandbox.transfersmile.com/api/payout/list

# This endpoint allows you to get payout list

# Parameters

Content-Type* string application/json; chartset=UTF-8
AppId* string Your App ID in payout platform
Authorization* string signature, generated by SHA256($sorted_params + $app_key)

# Body

start_time* string start_time(UTC), e.g. 2021-07-01 00:00:00
end_time* string end_time(UTC), e.g. 2021-08-01 00:00:00
page_num integer paging param, page number, should start from 1, while 0 is incorrect
page_size integer paging param, rows will be returned, max 1000
timestamp* integer unix timestamp, e.g. 1628512575

# Responses

200 Payout list successfully retrieved.
{
    "code": 200,
    "msg": "success",
    "time": 1628500091,
    "data": [
        {
            "reference_id": "custom_codexxxx",
            "transaction_id": "TS202108090705014iNqtxektRS",
            "user_name": "GUILHERME ALVES DE SOUZA",
            "bank_id": "EXXXXD", // only supported by pix payout.
            "amount": "0.6",
            "source_amount": "0.6",
            "settlement_amount": "0.6",
            "source_currency": "BRL",
            "arrival_amount": "0.57",
            "arrival_currency": "BRL",
            "exchange_rate": "1",
            "tax": "0.02",
            "fee": "0.01",
            "fee_user": "beneficiary",
            "transaction_status": "PROCESSING",
            "create_time": 1625142259,
            "update_time": 1625142261
        },
        ... ...
    ]
}
400 Request has expired
{
    "code": 4001009,
    "msg": "request has expired",
    "time": 1628512773,
    "data": {}
}

# Example

curl --location --request POST 'https://sandbox.transfersmile.com/api/payout/list' \
--header 'AppId: 94FAC**********************68548' \
--header 'Authorization: d6181db0d6548b94b162e75d095b59147172d914699f83b2bd17951a671b6302' \
--header 'Content-Type: application/json' \
--data-raw '{
    "start_time": "2021-07-01 00:00:00",
    "end_time": "2021-08-01 00:00:00",
    "page_size": 5,
    "page_num": 1, // should start from the number 1, while 0 is incorrect.
    "timestamp": 1628512575
}'

TIP

Note: 94FAC**********************68548 is transfersmile's test merchant id for sandbox, and d6181db0d6548b94b162e75d095b59147172d914699f83b2bd17951a671b6302 is authorization token associated with the test App ID.

TIP

Note: The page_num should start from the number 1, while 0 is incorrect.