Data types

The Paddle Invoice API uses JSON formatted data for requests and responses.

When making requests, specify application/json as your Content-Type. For example:

Content-Type: application/json

Dates and times

All dates and times use the RFC 3339 format. For example, 8:50pm on October 12th 2023 looks like this:

2023-10-12T20:50:00.52Z

Timezones

All dates and times are UTC.

Money

When working with money, specify values in the lowest denomination of a currency. For example, use cents for USD.

Here are some concrete examples:

Currency	Example	Value for API
USD	$24.99	2499
GBP	£49.00	4900
JPY	¥1000	1000

Don’t include a thousands separator.

For sub-unit pricing, you can use decimal values. Use a period . as the decimal separator.

Custom data

You can attach your own custom data to invoice entities. Custom data should be valid structured JSON.

See: Custom data