List catalog items
Read your merchant catalog with offset pagination.
/api/itemsList the authenticated merchant catalog. Requires merchant-id and signature headers.
| Field | Type | Required | Description |
|---|---|---|---|
limitquery | string | No | Page size; query is a decimal string from 1 to 100. Default 25. |
offsetquery | string | No | Non-negative offset with no leading zeroes, at most nine digits. Default 0. |
include_archivedquery | string | No | Whether archived items are included. Default false. |
Source: download OpenAPI 3.1. Examples below use illustrative values.
Set CRYPTIUM_API_URL to your API origin. Authenticated examples also use CRYPTIUM_MERCHANT_ID and CRYPTIUM_API_KEY from your server environment. Replace the example IDs and asset codes with values from your deployment.
signature=$(printf '%s' '{}' | openssl dgst -sha256 -hmac "$CRYPTIUM_API_KEY" -r)
signature=${signature%% *}
curl --silent --show-error --fail-with-body --max-time 15 \
--request GET "${CRYPTIUM_API_URL%/}/api/items?limit=25&offset=0&include_archived=false" \
--header "merchant-id: $CRYPTIUM_MERCHANT_ID" \
--header "signature: $signature"cURL requires OpenSSL and cURL 7.76+. JavaScript uses Node.js 18+; Python 3 uses the standard library; PHP requires the cURL extension. JSON bodies are compact UTF-8: sign the serialization described in authentication.
Request
Sign {} for this bodyless GET, including when using query parameters:
GET /api/items?limit=25&offset=0&include_archived=false
merchant-id: YOUR_MERCHANT_ID
signature: YOUR_COMPUTED_SIGNATUREResponse
Returns a plain JSON array of catalog items. There is no data, total, or cursor wrapper. The default limit is 25 and offset is 0; archived items are excluded unless requested.
Results are ordered by creation time descending, then ID descending. Continue with a larger offset until a page contains fewer items than the requested limit. A catalog changing between requests can affect offset pagination.
Query values are strings. Use true or false literally for include_archived; values such as 1 are rejected. The limit is 1 to 100 and offset uses a non-negative integer with no leading zeroes, up to nine digits.
Catalog changes are made through the merchant console. This endpoint only reads items for the authenticated merchant.