List Products

Search and paginate through your account's product catalog. Use this to discover the product names you need to pass to add_products in the upsert-lead request.

List-only via API

Only listing products is supported via API. To create, edit, or delete products, use the Superfone dashboard.

Authentication Required

Requires the x-api-key header. See Overview for details.

HTTP Request

GET /enterprise/api/product

Query Parameters

Parameter	Type	Required	Default	Description
text	string	No	—	Case-insensitive substring filter on the product title
page	number	No	1	Page number — starts at 1, not 0
page_size	number	No	50	Items per page

Try it

Loading playground…

Code Examples

cURL

curl -X GET "https://prod-api.superfone.co.in/superfone/enterprise/api/product?text=starter" \
  -H "x-api-key: your_api_key_here"

JavaScript

const url = new URL(
  'https://prod-api.superfone.co.in/superfone/enterprise/api/product'
);
url.searchParams.set('text', 'starter');

const response = await fetch(url, {
  method: 'GET',
  headers: { 'x-api-key': process.env.SF_API_KEY }
});

const result = await response.json();
console.log(result.data.rows);

Python

import os
import requests

response = requests.get(
    'https://prod-api.superfone.co.in/superfone/enterprise/api/product',
    headers={'x-api-key': os.environ['SF_API_KEY']},
    params={'text': 'starter'}
)
print(response.json()['data'])

Success Response

Status Code: 200 OK

{
  "data": {
    "rows": [
      {
        "id": 5,
        "org_id": 42,
        "title": "Starter Plan",
        "description": "Entry-level subscription, billed monthly.",
        "status": "ACTIVE",
        "price": 999,
        "currency": "INR",
        "link": "https://example.com/plans/starter",
        "images": {},
        "created_by": 678,
        "updated_by": null,
        "created_at": "2026-02-01T09:00:00.000Z",
        "updated_at": "2026-02-01T09:00:00.000Z"
      }
    ],
    "total_pages": 1,
    "current_page": 1,
    "page_size": 50,
    "total_items": 1
  },
  "message": "success"
}

Response Fields

Field	Type	Description
data.rows[].id	number	Internal product ID
data.rows[].title	string	Product name — this is the value to pass in add_products
data.rows[].description	string | null	Product description
data.rows[].status	string	ACTIVE or DISABLED
data.rows[].price	number	Price
data.rows[].currency	string	ISO 4217 currency code (e.g. INR)
data.rows[].link	string | null	Optional product URL
data.rows[].images	object	Image metadata (JSON object)
data.rows[].created_at	string	ISO 8601 timestamp
data.rows[].updated_at	string	ISO 8601 timestamp

Error Responses

Status	Message	When it occurs
401	UnAuthorized, Please Provide Valid API Key	Missing or invalid x-api-key

Related Endpoints

• Create or Update Lead — Pass the returned title values in add_products