Skip to main content
GET
/
customers
/
{external_customer_id}
/
analytics
/
overdue-balance
Retrieve customer analytics for overdue balance
curl --request GET \
  --url https://api-m.sandbox.paypal.com/v1/commerce/billing/customers/{external_customer_id}/analytics/overdue-balance \
  --header 'Authorization: Bearer <token>'
{
  "overdue_balances": [
    {
      "month": "2023-11",
      "amount": {
        "value": 55,
        "currency_code": "USD"
      },
      "invoice_ids": [
        "5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba"
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Use the /v1/oauth2/token endpoint to obtain an access token and pass it as a Bearer token in the Authorization header.

Path Parameters

​
external_customer_id
string
required

The unique external identifier of the customer used to filter their overdue balance.

Query Parameters

​
months
integer
default:12

Limits the analytics data to the specified number of most recent months. Defaults to 12 if not provided.

Required range: x >= 1
​
currency
string

Filters the analytics data by the specified currency code (e.g., 'USD'). Currency code in ISO 4217 format.

Required string length: 3
Example:

"USD"

Response

Customer overdue balance analytics retrieved successfully

Represents a collection of monthly overdue balance records for a specific customer.

​
overdue_balances
object[]

An array of monthly overdue balance entries for the specified customer.