Skip to main content
GET
List Products

List Products

Returns a paginated list of all published products for your business.

Request

string
required
Your API key

Query Parameters

string
Filter by product type: physical_product, digital, or gift_card
integer
Filter by product category ID
string
Filter by category slug or name. Comma-separated for multiple.
string
default:"updatedAt"
Field to sort by
string
default:"DESC"
Sort order: “ASC” or “DESC”
integer
default:"20"
Items per page (max 100)
integer
default:"0"
Number of products to skip, for pagination
This endpoint does not convert prices. Every product comes back in its base currency, and a currency parameter is ignored. See Displaying prices in multiple currencies.

Response

Displaying prices in multiple currencies

List Products gives you the catalog in each product’s base currency. To show prices in the customer’s currency:
  1. Load the supported codes once from Get Currencies.
  2. Default to the customer’s local currency, detected from their IP, and let them change it. Get Currencies explains how.
  3. Fetch each product’s converted price with Get Product (GET /product/{id}?currency=NGN) or Get Product Pricing. Cache the results per currency — rates only need refreshing every few minutes.
For fees and final totals at checkout, see Prices, Fees and Totals.

Example