List products
GET {{baseUrl}}/products
Returns a paginated list of products. Use the query parameters to page through results.
By default, Paddle returns products that are active
. Use the status
query parameter to return products that are archived.
Use the include
parameter to include related price entities in the response.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
after | string | Return entities after the specified Paddle ID when working with paginated endpoints. Used in the meta.pagination.next URL in responses for list operations. | |
id | string | Return only the IDs specified. Use a comma-separated list to get multiple entities. | |
include | string | Include related entities in the response. Use a comma-separated list to specify multiple entities. | |
order_by | string | Order returned entities by the specified field and direction ([ASC] or [DESC] ). For example, ?order_by=id[ASC] . |
Valid fields for ordering: id
. |
| per_page
| number | | Set how many entities are returned per page. Paddle returns the maximum number of results if a number greater than the maximum is requested. Check meta.pagination.per_page
in the response to see how many were returned.
Default: 50
; Maximum: 200
. |
| status
| string | | Return entities that match the specified status. Use a comma-separated list to specify multiple status values. |
| tax_category
| string | | Return entities that match the specified tax category. Use a comma-separated list to specify multiple tax categories. |
| type
| string | | Return items that match the specified type. |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |