POST
/
payouts
/
list
curl --request POST \
  --url https://sandbox.hyperswitch.io/payouts/list \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '{
  "start_time": "2023-11-07T05:31:56Z",
  "end_time": "2023-11-07T05:31:56Z",
  "payout_id": "187282ab-40ef-47a9-9206-5099ba31e432",
  "profile_id": "<string>",
  "customer_id": "cus_y3oqhf46pyzuxjbcn2giaqnb44",
  "limit": 1,
  "offset": 1,
  "connector": [
    "wise",
    "adyen"
  ],
  "currency": "AED",
  "status": [
    "pending",
    "failed"
  ],
  "payout_method": [
    "bank",
    "card"
  ],
  "entity_type": "Individual"
}'
{
  "size": 1,
  "data": [
    {
      "payout_id": "187282ab-40ef-47a9-9206-5099ba31e432",
      "merchant_id": "merchant_1668273825",
      "amount": 1000,
      "currency": "AED",
      "connector": "wise",
      "payout_type": "card",
      "payout_method_data": {
        "card": {
          "card_issuer": "<string>",
          "card_network": "Visa",
          "card_type": "<string>",
          "card_issuing_country": "<string>",
          "bank_code": "<string>",
          "last4": "<string>",
          "card_isin": "<string>",
          "card_extended_bin": "<string>",
          "card_exp_month": "01",
          "card_exp_year": "2026",
          "card_holder_name": "John Doe"
        }
      },
      "billing": {
        "address": {
          "city": "New York",
          "country": "AF",
          "line1": "123, King Street",
          "line2": "Powelson Avenue",
          "line3": "Bridgewater",
          "zip": "08807",
          "state": "New York",
          "first_name": "John",
          "last_name": "Doe"
        },
        "phone": {
          "number": "9123456789",
          "country_code": "+1"
        },
        "email": "<string>"
      },
      "auto_fulfill": true,
      "customer_id": "cus_y3oqhf46pyzuxjbcn2giaqnb44",
      "customer": {
        "id": "cus_y3oqhf46pyzuxjbcn2giaqnb44",
        "name": "John Doe",
        "email": "johntest@test.com",
        "phone": "9123456789",
        "phone_country_code": "+1"
      },
      "client_secret": "pay_U42c409qyHwOkWo3vK60_secret_el9ksDkiB8hi6j9N78yo",
      "return_url": "https://hyperswitch.io",
      "business_country": "AF",
      "business_label": "food",
      "description": "It's my first payout request",
      "entity_type": "Individual",
      "recurring": false,
      "metadata": {},
      "merchant_connector_id": "mca_sAD3OZLATetvjLOYhUSy",
      "status": "success",
      "error_message": "Failed while verifying the card",
      "error_code": "E0001",
      "profile_id": "<string>",
      "created": "2022-09-10T10:11:12Z",
      "connector_transaction_id": "S3FC9G9M2MVFDXT5",
      "priority": "instant",
      "attempts": [
        {
          "attempt_id": "<string>",
          "status": "success",
          "amount": 6583,
          "currency": "AED",
          "connector": "<string>",
          "error_code": "<string>",
          "error_message": "<string>",
          "payment_method": "card",
          "payout_method_type": "ach",
          "connector_transaction_id": "<string>",
          "cancellation_reason": "<string>",
          "unified_code": "UE_000",
          "unified_message": "Invalid card details"
        }
      ],
      "payout_link": {
        "payout_link_id": "<string>",
        "link": "<string>"
      },
      "email": "johntest@test.com",
      "name": "John Test",
      "phone": "9123456789",
      "phone_country_code": "+1",
      "unified_code": "UE_000",
      "unified_message": "Invalid card details",
      "payout_method_id": "<string>"
    }
  ],
  "total_count": 123
}

Authorizations

api-key
string
header
required

Use the API key created under your merchant account from the HyperSwitch dashboard. API key is used to authenticate API requests from your merchant server only. Don't expose this key on a website or embed it in a mobile application.

Body

application/json

A type representing a range of time for filtering, including a mandatory start time and an optional end time.

start_time
string
required

The start time to filter payments list or to get list of filters. To get list of filters start time is needed to be passed

currency
enum<string>
required

The three letter ISO currency code in uppercase. Eg: 'USD' for the United States Dollar.

Available options:
AED,
AFN,
ALL,
AMD,
ANG,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BHD,
BIF,
BMD,
BND,
BOB,
BRL,
BSD,
BTN,
BWP,
BYN,
BZD,
CAD,
CDF,
CHF,
CLP,
CNY,
COP,
CRC,
CUP,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EGP,
ERN,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GHS,
GIP,
GMD,
GNF,
GTQ,
GYD,
HKD,
HNL,
HRK,
HTG,
HUF,
IDR,
ILS,
INR,
IQD,
IRR,
ISK,
JMD,
JOD,
JPY,
KES,
KGS,
KHR,
KMF,
KPW,
KRW,
KWD,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
LYD,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRU,
MUR,
MVR,
MWK,
MXN,
MYR,
MZN,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
OMR,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
RWF,
SAR,
SBD,
SCR,
SDG,
SEK,
SGD,
SHP,
SLE,
SLL,
SOS,
SRD,
SSP,
STN,
SVC,
SYP,
SZL,
THB,
TJS,
TMT,
TND,
TOP,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
UYU,
UZS,
VES,
VND,
VUV,
WST,
XAF,
XCD,
XOF,
XPF,
YER,
ZAR,
ZMW,
ZWL
entity_type
enum<string>
required

Type of entity to whom the payout is being carried out to, select from the given list of options

Available options:
Individual,
Company,
NonProfit,
PublicSector,
NaturalPerson,
lowercase,
Personal
end_time
string | null

The end time to filter payments list or to get list of filters. If not passed the default time is now

payout_id
string | null

The identifier for payout

Required string length: 30
Example:

"187282ab-40ef-47a9-9206-5099ba31e432"

profile_id
string | null

The identifier for business profile

customer_id
string | null

The identifier for customer

Example:

"cus_y3oqhf46pyzuxjbcn2giaqnb44"

limit
integer

The limit on the number of objects. The default limit is 10 and max limit is 20

Required range: x >= 0
offset
integer | null

The starting point within a list of objects

Required range: x >= 0
connector
enum<string>[] | null

The list of connectors to filter payouts list

Available options:
adyen,
adyenplatform,
cybersource,
ebanx,
nomupay,
payone,
paypal,
stripe,
wise
Example:
["wise", "adyen"]
status
enum<string>[] | null

The list of payout status to filter payouts list

Available options:
success,
failed,
cancelled,
initiated,
expired,
reversed,
pending,
ineligible,
requires_creation,
requires_confirmation,
requires_payout_method_data,
requires_fulfillment,
requires_vendor_account_creation
Example:
["pending", "failed"]
payout_method
enum<string>[] | null

The list of payout methods to filter payouts list

The payout_type of the payout request is a mandatory field for confirming the payouts. It should be specified in the Create request. If not provided, it must be updated in the Payout Update request before it can be confirmed.

Available options:
card,
bank,
wallet
Example:
["bank", "card"]

Response

200
application/json
Payouts filtered
size
integer
required

The number of payouts included in the list

Required range: x >= 0
data
object[]
required

The list of payouts response objects

total_count
integer | null

The total number of available payouts for given constraints