PApaddlehq
Products

List products

Changed on

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.

get/products

Request

  • Base URL
    https://sandbox-api.paddle.com
  • Auth
    HTTP bearer

Query parameters

idstring[]

Return only the IDs specified. Use a comma-separated list to get multiple entities.

afterstring

Return entities after the specified Paddle ID when working with paginated endpoints. Used in the meta.pagination.next URL in responses for list operations.

per_pageinteger

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.

includeProductIncludeEnum[]

Include related entities in the response. Use a comma-separated list to specify multiple entities.

order_bystring

Order returned entities by the specified field and direction ([ASC] or [DESC]). For example, ?order_by=id[ASC].

Valid fields for ordering: created_at, custom_data, description, id, image_url, name, status, tax_category, and updated_at.

statusStatusQuery[]

Return entities that match the specified status. Use a comma-separated list to specify multiple status values.

tax_categoryTaxCategoryQueryEnum[]

Return entities that match the specified tax category. Use a comma-separated list to specify multiple tax categories.

type'custom' | 'standard'

Type of item. Standard items are considered part of your catalog and are shown in the Paddle dashboard.

Return items that match the specified type.

Headers

Skip-Countstring

Set to true to skip the count query on list operations. When set, meta.pagination.estimated_total returns -1 instead of an exact count.

Response

The request has succeeded.

Changes

  • v14f35a8c6ea4dRevision changes
    • breaking

      added to the ///////// response property oneOf list for the response status

    • breaking

      added to the /////// response property oneOf list for the response status

  • v1e1ac347eb3c5Revision changes
    • warning

      added the new CLP enum value to the ////// response property for the response status

    • warning

      added the new CLP enum value to the //////// response property for the response status

    • warning

      added the new PEN enum value to the ////// response property for the response status

    • warning

      added the new PEN enum value to the //////// response property for the response status

    • info

      added the new optional header request parameter Skip-Count

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status