PayPal REST API Samples

Request Object

{
    "sender_batch_header": {
        "sender_batch_id": "6a2a05c0df607",
        "email_subject": "You have a payment"
    },
    "items": [
        {
            "recipient_type": "Email",
            "note": "Thanks you.",
            "receiver": "shirt-supplier-one@gmail.com",
            "sender_item_id": "item_16a2a05c0df784",
            "amount": {
                "value": "0.99",
                "currency": "USD"
            }
        },
        {
            "recipient_type": "EMAIL",
            "amount": {
                "value": "0.90",
                "currency": "USD"
            },
            "receiver": "shirt-supplier-two@mail.com",
            "note": "Thank you.",
            "sender_item_id": "item_2"
        },
        {
            "recipient_type": "EMAIL",
            "receiver": "shirt-supplier-three@mail.com",
            "note": "Thank you.",
            "sender_item_id": "6a2a05c0df8a5",
            "amount": {
                "value": "0.90",
                "currency": "USD"
            }
        }
    ]
}

Response Object

{
    "batch_header": {
        "payout_batch_id": "D9W7DB2AENL8G",
        "batch_status": "PENDING",
        "sender_batch_header": {
            "sender_batch_id": "6a2a05c0df607",
            "email_subject": "You have a payment"
        }
    },
    "links": [
        {
            "href": "https://api.sandbox.paypal.com/v1/payments/payouts/D9W7DB2AENL8G",
            "rel": "self",
            "method": "GET",
            "enctype": "application/json"
        }
    ]
}

Request
Response

Request Object

{
    "sender_batch_header": {
        "sender_batch_id": "6a2a05c0df607",
        "email_subject": "You have a payment"
    },
    "items": [
        {
            "recipient_type": "Email",
            "note": "Thanks you.",
            "receiver": "shirt-supplier-one@gmail.com",
            "sender_item_id": "item_16a2a05c0df784",
            "amount": {
                "value": "0.99",
                "currency": "USD"
            }
        },
        {
            "recipient_type": "EMAIL",
            "amount": {
                "value": "0.90",
                "currency": "USD"
            },
            "receiver": "shirt-supplier-two@mail.com",
            "note": "Thank you.",
            "sender_item_id": "item_2"
        },
        {
            "recipient_type": "EMAIL",
            "receiver": "shirt-supplier-three@mail.com",
            "note": "Thank you.",
            "sender_item_id": "6a2a05c0df8a5",
            "amount": {
                "value": "0.90",
                "currency": "USD"
            }
        }
    ]
}

Response Object

{
    "batch_header": {
        "payout_batch_id": "D9W7DB2AENL8G",
        "batch_status": "PENDING",
        "sender_batch_header": {
            "sender_batch_id": "6a2a05c0df607",
            "email_subject": "You have a payment"
        }
    },
    "links": [
        {
            "href": "https://api.sandbox.paypal.com/v1/payments/payouts/D9W7DB2AENL8G",
            "rel": "self",
            "method": "GET",
            "enctype": "application/json"
        }
    ]
}

Request Object

No Data

Response Object

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/steelmin/public_html/api_v2/vendor-bk/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

{
    "batch_header": {
        "payout_batch_id": "D9W7DB2AENL8G",
        "batch_status": "PENDING",
        "time_created": "2026-06-11T00:48:01Z",
        "sender_batch_header": {
            "sender_batch_id": "6a2a05c0df607",
            "email_subject": "You have a payment"
        },
        "funding_source": "BALANCE",
        "amount": {
            "currency": "USD",
            "value": "2.79"
        }
    },
    "items": [
        {
            "payout_item_id": "MQ5ZSW8ZGQ62W",
            "transaction_status": "PENDING",
            "payout_batch_id": "D9W7DB2AENL8G",
            "payout_item": {
                "recipient_type": "EMAIL",
                "amount": {
                    "currency": "USD",
                    "value": "0.99"
                },
                "note": "Thanks you.",
                "receiver": "shirt-supplier-one@gmail.com",
                "sender_item_id": "item_16a2a05c0df784",
                "recipient_wallet": "PAYPAL",
                "purpose": "GOODS"
            },
            "links": [
                {
                    "href": "https://api.sandbox.paypal.com/v1/payments/payouts-item/MQ5ZSW8ZGQ62W",
                    "rel": "item",
                    "method": "GET",
                    "enctype": "application/json"
                }
            ]
        },
        {
            "payout_item_id": "VWX89G27H6UWG",
            "transaction_status": "PENDING",
            "payout_batch_id": "D9W7DB2AENL8G",
            "payout_item": {
                "recipient_type": "EMAIL",
                "amount": {
                    "currency": "USD",
                    "value": "0.90"
                },
                "note": "Thank you.",
                "receiver": "shirt-supplier-two@mail.com",
                "sender_item_id": "item_2",
                "recipient_wallet": "PAYPAL",
                "purpose": "GOODS"
            },
            "links": [
                {
                    "href": "https://api.sandbox.paypal.com/v1/payments/payouts-item/VWX89G27H6UWG",
                    "rel": "item",
                    "method": "GET",
                    "enctype": "application/json"
                }
            ]
        },
        {
            "payout_item_id": "TRZP8RVKSBFYQ",
            "transaction_status": "PENDING",
            "payout_batch_id": "D9W7DB2AENL8G",
            "payout_item": {
                "recipient_type": "EMAIL",
                "amount": {
                    "currency": "USD",
                    "value": "0.90"
                },
                "note": "Thank you.",
                "receiver": "shirt-supplier-three@mail.com",
                "sender_item_id": "6a2a05c0df8a5",
                "recipient_wallet": "PAYPAL",
                "purpose": "GOODS"
            },
            "links": [
                {
                    "href": "https://api.sandbox.paypal.com/v1/payments/payouts-item/TRZP8RVKSBFYQ",
                    "rel": "item",
                    "method": "GET",
                    "enctype": "application/json"
                }
            ]
        }
    ],
    "links": [
        {
            "href": "https://api.sandbox.paypal.com/v1/payments/payouts/D9W7DB2AENL8G?page_size=1000&page=1",
            "rel": "self",
            "method": "GET",
            "enctype": "application/json"
        }
    ]
}

Request
Response

Request Object

No Data

Response Object

{
    "batch_header": {
        "payout_batch_id": "D9W7DB2AENL8G",
        "batch_status": "PENDING",
        "time_created": "2026-06-11T00:48:01Z",
        "sender_batch_header": {
            "sender_batch_id": "6a2a05c0df607",
            "email_subject": "You have a payment"
        },
        "funding_source": "BALANCE",
        "amount": {
            "currency": "USD",
            "value": "2.79"
        }
    },
    "items": [
        {
            "payout_item_id": "MQ5ZSW8ZGQ62W",
            "transaction_status": "PENDING",
            "payout_batch_id": "D9W7DB2AENL8G",
            "payout_item": {
                "recipient_type": "EMAIL",
                "amount": {
                    "currency": "USD",
                    "value": "0.99"
                },
                "note": "Thanks you.",
                "receiver": "shirt-supplier-one@gmail.com",
                "sender_item_id": "item_16a2a05c0df784",
                "recipient_wallet": "PAYPAL",
                "purpose": "GOODS"
            },
            "links": [
                {
                    "href": "https://api.sandbox.paypal.com/v1/payments/payouts-item/MQ5ZSW8ZGQ62W",
                    "rel": "item",
                    "method": "GET",
                    "enctype": "application/json"
                }
            ]
        },
        {
            "payout_item_id": "VWX89G27H6UWG",
            "transaction_status": "PENDING",
            "payout_batch_id": "D9W7DB2AENL8G",
            "payout_item": {
                "recipient_type": "EMAIL",
                "amount": {
                    "currency": "USD",
                    "value": "0.90"
                },
                "note": "Thank you.",
                "receiver": "shirt-supplier-two@mail.com",
                "sender_item_id": "item_2",
                "recipient_wallet": "PAYPAL",
                "purpose": "GOODS"
            },
            "links": [
                {
                    "href": "https://api.sandbox.paypal.com/v1/payments/payouts-item/VWX89G27H6UWG",
                    "rel": "item",
                    "method": "GET",
                    "enctype": "application/json"
                }
            ]
        },
        {
            "payout_item_id": "TRZP8RVKSBFYQ",
            "transaction_status": "PENDING",
            "payout_batch_id": "D9W7DB2AENL8G",
            "payout_item": {
                "recipient_type": "EMAIL",
                "amount": {
                    "currency": "USD",
                    "value": "0.90"
                },
                "note": "Thank you.",
                "receiver": "shirt-supplier-three@mail.com",
                "sender_item_id": "6a2a05c0df8a5",
                "recipient_wallet": "PAYPAL",
                "purpose": "GOODS"
            },
            "links": [
                {
                    "href": "https://api.sandbox.paypal.com/v1/payments/payouts-item/TRZP8RVKSBFYQ",
                    "rel": "item",
                    "method": "GET",
                    "enctype": "application/json"
                }
            ]
        }
    ],
    "links": [
        {
            "href": "https://api.sandbox.paypal.com/v1/payments/payouts/D9W7DB2AENL8G?page_size=1000&page=1",
            "rel": "self",
            "method": "GET",
            "enctype": "application/json"
        }
    ]
}

❮❮ Back to Samples

1. Created Batch Payout

Request Object

Response Object

Request Object

Response Object

2. Get Payout Batch Status

Request Object

Response Object

Request Object

Response Object