Addresses

Addresses are sub-entities of customers. They store components of a customer billing address as key-value pairs so they’re easy to read and update.

Each customer has its own addresses. They’re not shared across customers.

You can add an address to an invoice to bill for products. Paddle uses the address on an invoice for tax calculation purposes.

Address object

$ref: ../../reference/models/address.yaml

Examples

{
  "id": "add_39lmJsg0LfRNOp15btRLtkn",
  "status": "active",
  "description": "Paddle USA",
  "first_line": "3811 Ditmars Blvd # 1071",
  "second_line": null,
  "city": "Astoria",
  "region": "New York",
  "postal_code": "11105-1803",
  "country_code": "US"
}

{
  "id": "add_01ghgm8wf77xwq89x5y2n3qx07",
  "status": "active",
  "description": "Paddle London",
  "first_line": "Judd House",
  "second_line": "18-29 Mora Street",
  "city": "London",
  "region": "Islington",
  "postal_code": "EC1V 8BT",
  "country_code": "GB"
}

Work with addresses

Using the Paddle Invoice API, you can:

• List addresses
• Create a new address
• Get a single address
• Update an existing address

Archive addresses

You can’t delete addresses, but you can archive them to say you no longer need them. Archived addresses can’t be used in Paddle and aren’t returned by default when you query the list endpoint.

To archive an address, use the update address method:

{
  "status": "archived"
}