Skip to main content
POST
/
v2
/
payouts
/
batch
Pay multiple requests in one transaction
curl --request POST \
  --url https://api.request.network/v2/payouts/batch \
  --header 'Content-Type: application/json' \
  --data '
{
  "requests": [
    {
      "payee": "0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7",
      "amount": "2",
      "invoiceCurrency": "FAU-sepolia",
      "paymentCurrency": "FAU-sepolia"
    },
    {
      "payee": "0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7",
      "amount": "2",
      "invoiceCurrency": "fUSDC-sepolia",
      "paymentCurrency": "fUSDC-sepolia"
    },
    {
      "payee": "0xb07D2398d2004378cad234DA0EF14f1c94A530e4",
      "amount": "10",
      "invoiceCurrency": "USD",
      "paymentCurrency": "FAU-sepolia"
    },
    {
      "payee": "0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7",
      "amount": "0.00001",
      "invoiceCurrency": "ETH-sepolia-sepolia",
      "paymentCurrency": "ETH-sepolia-sepolia"
    },
    {
      "payee": "0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7",
      "amount": "10",
      "invoiceCurrency": "USD",
      "paymentCurrency": "ETH-sepolia-sepolia"
    }
  ],
  "payer": "0x2e2E5C79F571ef1658d4C2d3684a1FE97DD30570"
}
'
{
  "ERC20ApprovalTransactions": [
    {
      "data": "0x095ea7b3...",
      "to": "0x370DE27fdb7D1Ff1e1BaA7D11c5820a324Cf623C",
      "value": 0
    }
  ],
  "batchPaymentTransaction": {
    "data": "0x92cddb91...",
    "to": "0x67818703c92580c0e106e401F253E8A410A66f8B",
    "value": {
      "type": "BigNumber",
      "hex": "0x0d83b3d1afc58b"
    }
  }
}

Headers

​
x-api-key
string

API key for authentication (optional if using Client ID)

​
x-client-id
string

Client ID for frontend authentication (optional if using API key)

​
Origin
string

Origin header (required for Client ID auth, automatically set by browser)

Body

application/json
​
requests
object[]

A list of payment requests to be created andprocessed in batch. All requests must be on the same network and contain payment/invoice currency information. Either requests or requestIds must be provided, but not both.

​
requestIds
string[]

The request IDs of the existing requests to be paid. Requests must be on the same network. Either requests or requestIds must be provided, but not both.

​
payer
string

The wallet address of the payer, user to check if approval is needed or not.

Response

Batch payment calldata retrieved successfully

​
ERC20ApprovalTransactions
object[]

Array of ERC20 approval transactions needed before the batch payment. Only present when token approval is required.

​
ERC20BatchPaymentTransaction
object

The batch payment transaction for ERC20 tokens. Only present when the batch contains ERC20 payments.

​
ETHBatchPaymentTransaction
object

The batch payment transaction for native ETH. Only present when the batch contains ETH payments.