❮❮ Back to Samples

Request Object

{
    "merchant_info": {
        "email": "jaypatel512-facilitator@hotmail.com",
        "first_name": "Dennis",
        "last_name": "Doctor",
        "business_name": "Medical Professionals, LLC",
        "phone": {
            "country_code": "001",
            "national_number": "5032141716"
        },
        "address": {
            "line1": "1234 Main St.",
            "city": "Portland",
            "state": "OR",
            "postal_code": "97217",
            "country_code": "US"
        }
    },
    "billing_info": [
        {
            "email": "example@example.com",
            "business_name": "Jay Inc",
            "additional_info": "This is the billing Info",
            "address": {
                "line1": "1234 Main St.",
                "city": "Portland",
                "state": "OR",
                "postal_code": "97217",
                "country_code": "US"
            }
        }
    ],
    "note": "Medical Invoice 16 Jul, 2013 PST",
    "payment_term": {
        "term_type": "NET_45"
    },
    "shipping_info": {
        "first_name": "Sally",
        "last_name": "Patient",
        "business_name": "Not applicable",
        "phone": {
            "country_code": "001",
            "national_number": "5039871234"
        },
        "address": {
            "line1": "1234 Main St.",
            "city": "Portland",
            "state": "OR",
            "postal_code": "97217",
            "country_code": "US"
        }
    },
    "items": [
        {
            "name": "Sutures",
            "quantity": "100",
            "unit_price": {
                "currency": "USD",
                "value": "5"
            },
            "tax": {
                "percent": "1",
                "name": "Local Tax on Sutures"
            }
        },
        {
            "name": "Injection",
            "quantity": "5",
            "discount": {
                "percent": "3.00"
            },
            "unit_price": {
                "currency": "USD",
                "value": "5"
            },
            "tax": {
                "percent": "3",
                "name": "Local Tax on Injection"
            }
        }
    ],
    "discount": {
        "percent": "2.00"
    },
    "logo_url": "https://www.paypalobjects.com/webstatic/i/logo/rebrand/ppcom.svg"
}

Response Object

{
    "merchant_info": {
        "email": "jaypatel512-facilitator@hotmail.com",
        "first_name": "Dennis",
        "last_name": "Doctor",
        "business_name": "Medical Professionals, LLC",
        "phone": {
            "country_code": "001",
            "national_number": "5032141716"
        },
        "address": {
            "line1": "1234 Main St.",
            "city": "Portland",
            "state": "OR",
            "postal_code": "97217",
            "country_code": "US"
        }
    },
    "billing_info": [
        {
            "email": "example@example.com",
            "business_name": "Jay Inc",
            "address": {
                "line1": "1234 Main St.",
                "city": "Portland",
                "state": "OR",
                "postal_code": "97217",
                "country_code": "US"
            },
            "additional_info": "This is the billing Info"
        }
    ],
    "note": "Medical Invoice 16 Jul, 2013 PST",
    "payment_term": {
        "term_type": "NET_45",
        "due_date": "2026-09-25 PDT"
    },
    "shipping_info": {
        "first_name": "Sally",
        "last_name": "Patient",
        "business_name": "Not applicable",
        "phone": {
            "country_code": "001",
            "national_number": "5039871234"
        },
        "address": {
            "line1": "1234 Main St.",
            "city": "Portland",
            "state": "OR",
            "postal_code": "97217",
            "country_code": "US"
        }
    },
    "items": [
        {
            "name": "Sutures",
            "quantity": "100",
            "unit_price": {
                "currency": "USD",
                "value": "5.00"
            },
            "tax": {
                "name": "Local Tax on Sutures",
                "percent": "1",
                "amount": {
                    "currency": "USD",
                    "value": "5.00"
                }
            }
        },
        {
            "name": "Injection",
            "quantity": "5",
            "unit_price": {
                "currency": "USD",
                "value": "5.00"
            },
            "tax": {
                "name": "Local Tax on Injection",
                "percent": "3",
                "amount": {
                    "currency": "USD",
                    "value": "0.75"
                }
            },
            "discount": {
                "percent": "3.00",
                "amount": {
                    "currency": "USD",
                    "value": "0.75"
                }
            }
        }
    ],
    "discount": {
        "percent": "2.00",
        "amount": {
            "currency": "USD",
            "value": "10.49"
        }
    },
    "logo_url": "https://www.paypalobjects.com/webstatic/i/logo/rebrand/ppcom.svg",
    "id": "INV2-9JBJ-HL9W-57ZT-5JHE",
    "number": "SSRF-SEND-1785686849",
    "template_id": "TEMP-10394883S32914143",
    "status": "DRAFT",
    "invoice_date": "2026-08-11 PDT",
    "tax_calculated_after_discount": false,
    "tax_inclusive": false,
    "total_amount": {
        "currency": "USD",
        "value": "519.51"
    },
    "metadata": {
        "created_date": "2026-08-11 14:43:50 PDT"
    },
    "allow_tip": false,
    "links": [
        {
            "rel": "self",
            "href": "https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-9JBJ-HL9W-57ZT-5JHE",
            "method": "GET"
        },
        {
            "rel": "send",
            "href": "https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-9JBJ-HL9W-57ZT-5JHE/send",
            "method": "POST"
        },
        {
            "rel": "replace",
            "href": "https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-9JBJ-HL9W-57ZT-5JHE/update",
            "method": "PUT"
        },
        {
            "rel": "delete",
            "href": "https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-9JBJ-HL9W-57ZT-5JHE",
            "method": "DELETE"
        },
        {
            "rel": "record-payment",
            "href": "https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-9JBJ-HL9W-57ZT-5JHE/record-payment",
            "method": "POST"
        }
    ]
}

Request Object

{
    "merchant_info": {
        "email": "jaypatel512-facilitator@hotmail.com",
        "first_name": "Dennis",
        "last_name": "Doctor",
        "business_name": "Medical Professionals, LLC",
        "phone": {
            "country_code": "001",
            "national_number": "5032141716"
        },
        "address": {
            "line1": "1234 Main St.",
            "city": "Portland",
            "state": "OR",
            "postal_code": "97217",
            "country_code": "US"
        }
    },
    "billing_info": [
        {
            "email": "example@example.com",
            "business_name": "Jay Inc",
            "additional_info": "This is the billing Info"
        }
    ],
    "note": "Medical Invoice 16 Jul, 2013 PST",
    "payment_term": {
        "term_type": "NET_45"
    },
    "shipping_info": {
        "first_name": "Sally",
        "last_name": "Patient",
        "business_name": "Not applicable",
        "phone": {
            "country_code": "001",
            "national_number": "5039871234"
        },
        "address": {
            "line1": "1234 Main St.",
            "city": "Portland",
            "state": "OR",
            "postal_code": "97217",
            "country_code": "US"
        }
    },
    "items": [
        {
            "name": "Sutures",
            "quantity": "100",
            "unit_price": {
                "currency": "USD",
                "value": "5.00"
            },
            "tax": {
                "name": "Local Tax on Sutures",
                "percent": "1",
                "amount": {
                    "currency": "USD",
                    "value": "5.00"
                }
            }
        },
        {
            "name": "Injection",
            "quantity": "5",
            "unit_price": {
                "currency": "USD",
                "value": "5.00"
            },
            "tax": {
                "name": "Local Tax on Injection",
                "percent": "3",
                "amount": {
                    "currency": "USD",
                    "value": "0.75"
                }
            },
            "discount": {
                "percent": "3.00",
                "amount": {
                    "currency": "USD",
                    "value": "0.75"
                }
            }
        }
    ],
    "discount": {
        "percent": "2.00",
        "amount": {
            "currency": "USD",
            "value": "10.49"
        }
    },
    "logo_url": "https://www.paypalobjects.com/webstatic/i/logo/rebrand/ppcom.svg",
    "id": "INV2-9JBJ-HL9W-57ZT-5JHE",
    "number": "SSRF-SEND-1785686849",
    "template_id": "TEMP-10394883S32914143",
    "status": "DRAFT",
    "invoice_date": "2026-08-11 PDT",
    "tax_calculated_after_discount": false,
    "tax_inclusive": false,
    "total_amount": {
        "currency": "USD",
        "value": "519.51"
    },
    "metadata": {
        "created_date": "2026-08-11 14:43:50 PDT"
    },
    "allow_tip": false,
    "links": [
        {
            "rel": "self",
            "href": "https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-9JBJ-HL9W-57ZT-5JHE",
            "method": "GET"
        },
        {
            "rel": "send",
            "href": "https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-9JBJ-HL9W-57ZT-5JHE/send",
            "method": "POST"
        },
        {
            "rel": "replace",
            "href": "https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-9JBJ-HL9W-57ZT-5JHE/update",
            "method": "PUT"
        },
        {
            "rel": "delete",
            "href": "https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-9JBJ-HL9W-57ZT-5JHE",
            "method": "DELETE"
        },
        {
            "rel": "record-payment",
            "href": "https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-9JBJ-HL9W-57ZT-5JHE/record-payment",
            "method": "POST"
        }
    ]
}

Response Object

Got Http response code 400 when accessing https://api.sandbox.paypal.com/v1/invoicing/invoices/INV2-9JBJ-HL9W-57ZT-5JHE.

{
    "name": "VALIDATION_ERROR",
    "message": "Invalid request - see details.",
    "information_link": "https://developer.paypal.com/docs/api/invoicing/#errors",
    "details": [
        {
            "field": "items[1].discount",
            "issue": "either percent or, amount is required."
        }
    ]
}