List services

GET 
/api/v1/services

Lists catalog products.

Without query parameters the endpoint returns the full, unpaginated catalog (legacy behaviour — unchanged response shape).

Filtering / pagination (additive):

• type: only products of one type (voucher | direct_topup | esim).
• search: case-insensitive substring match on the service name.
• limit + offset: server-side pagination window. When the paginated form is used (limit and/or offset present), the response additionally carries total — the number of products matching the filters — so clients can iterate offset += limit until offset >= total.

eSIM products (type=esim) are priced in USD (always) and may carry an imageUrl (region flag fallback). Purchasing eSIM requires the product:read scope for the catalog plus orders:write / orders:read for POST /orders / GET /orders — no separate esim scope exists.

Request

Responses

200

Successful Response

422

Validation Error