Version: v2.0

Product Catalogue

You can access your product catalogue via a single request. This endpoint will show you the complete list of products and their respective Ids, which can be used in an order to activate/topup eSIM profiles or physical SIMs. Each plan also contains the type of SIM it can be used with which can be: ESIM, PSIM, or actually both at the same time. Make sure to use the right type of plan for your use-case.

Example Request#

curl -X GET \
  https://services.truphone.com/connect-api/v2/products \
   -H "Authorization: Bearer $ACCESS_TOKEN" \
   -H 'Cache-Control: no-cache' \
   -H 'Content-Type: application/json' \
   -H 'X-Correlation-ID: unique-id-from-requester-123'

Example Response#

{
  "data": [
    {
      "id": "wp-_bXkuC26SFDSRMHyiAQK7LJ6MtiWyr3zLfwB7FM=",
      "name": "Plan name",
      "sim_type": [
        "ESIM"
      ],
      "duration": 90,
      "duration_unit": "DAYS",
      "data": 50,
      "data_unit": "MB",
      "price": 20,
      "price_currency": "EUR",
      "footprint_code": "GLOBAL",
      "_metadata": {
        "links": {
          "_self": "{BASE_URL}/v2/products/wp-_bXkuC26SFDSRMHyiAQK7LJ6MtiWyr3zLfwB7FM="
        }
      }
    },
    ...
  ],
  "_metadata": {
    "links": {
      "_self": "{BASE_URL}/v2/products?page=1&page_size=10"
    },
    "page": 1,
    "page_size": 10,
    "page_count": 1
  }
}