List plans

curl --request GET \
  --url https://api.spenza.com/api/v1.1/plans \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.spenza.com/api/v1.1/plans', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.spenza.com/api/v1.1/plans",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.spenza.com/api/v1.1/plans"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.spenza.com/api/v1.1/plans")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": [
    {
      "productId": "AT&T 5GB",
      "description": "Unlimited talk & text + 5GB data",
      "price": 49.99,
      "currency": "usd",
      "validityDays": 30,
      "data": {
        "value": 5,
        "unit": "GB"
      },
      "voiceMinutes": 1000,
      "smsCount": 500,
      "operator": "AT&T",
      "network": "AT&T",
      "isEsim": false,
      "planType": "FLAT_RATE",
      "recurring": true
    },
    {
      "productId": "Pay-As-You-Go Data",
      "description": "Pay-as-you-go data, voice & SMS",
      "price": 0,
      "currency": "usd",
      "validityDays": 30,
      "data": {
        "value": null,
        "unit": null
      },
      "voiceMinutes": 0,
      "smsCount": 0,
      "operator": "AT&T",
      "network": "AT&T",
      "isEsim": false,
      "planType": "PAY_AS_YOU_GO",
      "recurring": false,
      "tieredPricing": {
        "dataTiers": [
          {
            "from": 0,
            "to": 1,
            "unit": "GB",
            "price": 5
          },
          {
            "from": 1,
            "to": null,
            "unit": "GB",
            "price": 4
          }
        ],
        "voiceTiers": [
          {
            "from": 0,
            "to": 100,
            "unit": "min",
            "price": 0.02
          }
        ],
        "smsTiers": [
          {
            "from": 0,
            "to": 100,
            "unit": "sms",
            "price": 0.01
          }
        ]
      },
      "volumeTierPricing": {
        "tiers": [
          {
            "minQuantity": 1,
            "maxQuantity": 9,
            "pricePerUnit": 49.99
          },
          {
            "minQuantity": 10,
            "maxQuantity": null,
            "pricePerUnit": 44.99
          }
        ]
      }
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 25,
    "total": 8,
    "totalPages": 1
  }
}

Plans & Catalog

List plans

List the plans your account may purchase. search requires searchType to be set (otherwise the search matches nothing rather than erroring loudly). Omitting category restricts results to MSP_PLAN and RESELLER_PLAN; supplying it narrows to exactly that one category.

productId carries the plan’s display name (for example "AT&T 5GB"), not an internal identifier — there is no separate productName field on this endpoint or on GET /api/v1.1/plans/{planId}.

Each plan optionally includes tieredPricing (only present when the plan’s planType is PAY_AS_YOU_GO) and/or volumeTierPricing (only present when volume-tiered pricing is enabled for the plan).

GET

api

v1.1

plans

List plans

curl --request GET \
  --url https://api.spenza.com/api/v1.1/plans \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.spenza.com/api/v1.1/plans', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.spenza.com/api/v1.1/plans",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.spenza.com/api/v1.1/plans"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.spenza.com/api/v1.1/plans")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": [
    {
      "productId": "AT&T 5GB",
      "description": "Unlimited talk & text + 5GB data",
      "price": 49.99,
      "currency": "usd",
      "validityDays": 30,
      "data": {
        "value": 5,
        "unit": "GB"
      },
      "voiceMinutes": 1000,
      "smsCount": 500,
      "operator": "AT&T",
      "network": "AT&T",
      "isEsim": false,
      "planType": "FLAT_RATE",
      "recurring": true
    },
    {
      "productId": "Pay-As-You-Go Data",
      "description": "Pay-as-you-go data, voice & SMS",
      "price": 0,
      "currency": "usd",
      "validityDays": 30,
      "data": {
        "value": null,
        "unit": null
      },
      "voiceMinutes": 0,
      "smsCount": 0,
      "operator": "AT&T",
      "network": "AT&T",
      "isEsim": false,
      "planType": "PAY_AS_YOU_GO",
      "recurring": false,
      "tieredPricing": {
        "dataTiers": [
          {
            "from": 0,
            "to": 1,
            "unit": "GB",
            "price": 5
          },
          {
            "from": 1,
            "to": null,
            "unit": "GB",
            "price": 4
          }
        ],
        "voiceTiers": [
          {
            "from": 0,
            "to": 100,
            "unit": "min",
            "price": 0.02
          }
        ],
        "smsTiers": [
          {
            "from": 0,
            "to": 100,
            "unit": "sms",
            "price": 0.01
          }
        ]
      },
      "volumeTierPricing": {
        "tiers": [
          {
            "minQuantity": 1,
            "maxQuantity": 9,
            "pricePerUnit": 49.99
          },
          {
            "minQuantity": 10,
            "maxQuantity": null,
            "pricePerUnit": 44.99
          }
        ]
      }
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 25,
    "total": 8,
    "totalPages": 1
  }
}

Authorizations

Authorization

string

header

required

Bearer token obtained from POST /api/v1.1/auth/token.

Query Parameters

page

integer

default:1

1-indexed page number.

Required range: x >= 1

pageSize

integer

default:25

Items per page.

Required range: 1 <= x <= 100

string

Example:

"AT&T 5GB"

searchType

enum<string>

Available options:

productName,

productId

Response

A page of plans.

Overview

Build

Reference

Help

API Reference

List plans

Authorizations

Query Parameters

Response