Paddle Billing
Search

Create a report

posthttps://api.paddle.com/reports

Creates a new report.

Reports are created as pending initially while Paddle generates your report. They move to ready when they're ready to download.

You can download a report when it's ready using the get a CSV file for a report operation.

If successful, your response includes a copy of the new report entity.

Request Body

typestringrequired

Type of report to create.

filtersarray[object]

Filter criteria for this report. If omitted when creating, reports are filtered to include data updated in the last 30 days. This means updated_at is greater than or equal to (gte) the date 30 days ago from the time the report was generated.

namestring

Field name to filter by.

operatorstring or null

Operator to use when filtering. Valid when filtering by updated_at, null otherwise.

valuearray or string

Value to filter by. Check the allowed values descriptions for the name field to see valid values for a field.

Response

dataobject

Represents a report entity.

typestring

Type of report to create.

idstring

Unique Paddle ID for this report, prefixed with rep_

statusstring

Status of this report. Set automatically by Paddle.

Reports are created as pending initially, then move to ready when they're available to download.

rowsinteger or null

Number of records in this report. null if the report is pending.

expires_atstring<date-time> or null

RFC 3339 datetime string of when this report expires. The report is no longer available to download after this date.

updated_atstring<date-time>

RFC 3339 datetime string of when this report was last updated.

created_atstring<date-time>

RFC 3339 datetime string of when this report was created.

filtersarray[object]

Filter criteria for this report. If omitted when creating, reports are filtered to include data updated in the last 30 days. This means updated_at is greater than or equal to (gte) the date 30 days ago from the time the report was generated.

namestring

Field name to filter by.

operatorstring or null

Operator to use when filtering. Valid when filtering by updated_at, null otherwise.

valuearray or string

Value to filter by. Check the allowed values descriptions for the name field to see valid values for a field.

metaobject

Information about this response.

request_idstring

Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.