Public API - Catalog

List services by country

Returns services available in a specific country with pricing tiers. Each service includes a prices[] array with serviceCountryPriceId values that can be used to create orders.

get/v1/public/services/list

Request

  • Base URL: https://api.sms-virtual.net
  • URL: https://api.sms-virtual.net/v1/public/services/list
  • Auth: API key in header x-api-key

Query parameters

pagenumber

Page number (1-based). Defaults to 1.

pageSizenumber

Items per page. Defaults to 10.

countryIdstring required

Country UUID from GET /v1/public/countries. Required — pricing is country-specific.

searchstring

Case-insensitive substring match on service name or code.

categoryIdstring

Filter by service category UUID. Omit for all categories.

statusstring

Filter by status: "1" = active, "0" = inactive. Omit for all.

sort'price_asc' | 'price_desc' | 'stock_desc' | 'name_asc' | 'name_desc' | 'discount_desc'

Sort order. Options: price_asc (cheapest first), price_desc (most expensive first), stock_desc (highest stock first), name_asc, name_desc, discount_desc (default - highest discount first).

Response

Services with country-specific pricing retrieved. Use data[].prices[].id (the serviceCountryPriceId) when placing orders. sellPrice is the list price; promoPrice is the active promotion (apply when isPromo: true).

Changes

No recorded changes to this operation across all 1 revision of this API.