Skip to main content
GET
/
products
List Products
curl --request GET \
  --url https://api.erysta.com/v1/partners/products \
  --header 'x-api-key: <api-key>'
{
  "status": 200,
  "success": true,
  "details": {
    "data": {
      "hits": 87,
      "products": [
        {
          "id": "prod_L4k8j3m",
          "title": "Elden Ring (PC)",
          "restrictions": {
            "whitelist": [
              "CA",
              "FR",
              "GB"
            ],
            "blacklist": [
              "DE"
            ]
          },
          "quantity": 14,
          "price": 34.99,
          "currency": "EUR"
        }
      ],
      "pages": {
        "page": 1,
        "total": 2,
        "limit": 50
      }
    },
    "extensions": {
      "cache": "no-store",
      "trace_id": "req-7f8a9b2c...",
      "timestamp": "2026-03-09T15:30:00.000Z"
    }
  }
}

Authorizations

​
x-api-key
string
header
required

Your secret API key.

Query Parameters

​
query
string

Search products by title or keywords.

​
in_stock
enum<string>

Filter by availability. 'true' returns only items in stock, 'false' only out of stock.

Available options:
true,
false
​
sort
enum<string>

Sorting criteria. Default is relevance.

Available options:
DATE_DESC,
DATE_ASC,
PRICE_ASC,
PRICE_DESC,
ALPHABET_ASC,
ALPHABET_DESC
​
currency
enum<string>

The currency in which to display prices.

Available options:
EUR,
GBP,
CHF,
PLN,
RUB,
UAH,
USD,
CAD,
AUD,
NZD
​
page
integer
default:1

The page number for pagination.

​
limit
integer
default:50

Number of products per page. Max 500.

Required range: x <= 500

Response

Successful retrieval

​
status
integer
Example:

200

​
success
boolean
Example:

true

​
details
object