Skip to main content
Billing entity management helps you update existing billing entities when your business requirements change. You can retrieve current billing entities and modify entity configurations, including assigning tax codes. This ensures proper billing context for different business divisions and jurisdictions.

​
List billing entities

Use a valid access token and send a GET request to /v1/commerce/billing/billing-entities. On successful request processing, PayPal returns an array of billing entities. 
curl -X GET 'https://api-m.sandbox.paypal.com/v1/commerce/billing/billing-entities' \
-H 'Authorization: Bearer <ACCESS-TOKEN>'
Note: For the exhaustive list of response parameters, see API reference.

​
Update billing entity details

Use a valid access token and send a PUT request to /v1/commerce/billing/billing-entities/{code} with the modified request parameters such as name, currency, address, legal information, contact details, and tax codes.
Note: You can also assign existing tax codes to billing entities. Include the tax_codes parameter that reference the created taxes.
Path parameter: code is the billing entity’s unique code identifier returned when you create the billing entity. On successful request processing, PayPal returns the updated billing entity information. 
curl -X PUT 'https://api-m.sandbox.paypal.com/v1/commerce/billing/billing-entities/acme_inc' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS-TOKEN>' \
-d '{
    "name": "Acme Inc (Updated)",
    "default_currency": "USD",
    "finalize_zero_amount_invoice": true,
    "address": {
        "line1": "123 Business Ave, Suite 500",
        "line2": "Floor 5",
        "city": "San Francisco",
        "state": "CA",
        "country": "US",
        "postal_code": "94107"
    },
    "legal_name": "Acme Corporation Inc. LLC",
    "legal_number": "US987654321",
    "tax_identification_number": "987-65-4321",
    "email": "billing-updated@acmeinc.com",
    "timezone": "America/Los_Angeles",
    "tax_codes": [
        "us_ca_sales_tax_8_25",
        "us_sf_city_tax_1_25"
    ]
}'
Note: For the exhaustive list of request and response parameter descriptions, see API reference.
⌘I