List Source Types

Search and paginate through the catalog of valid source_type values that can be passed when creating or updating a lead.

Read-only catalog

Source types are system-defined and maintained by Superfone. They cannot be created, edited, or deleted — neither via API nor from the dashboard. Use this endpoint only to discover the valid title values to send as source_type.

Authentication Required

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

HTTP Request

GET /enterprise/api/source-type

Query Parameters

Parameter	Type	Required	Default	Description
text	string	No	—	Case-insensitive substring filter on the source type 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/source-type?page=1&page_size=50" \
  -H "x-api-key: your_api_key_here"

JavaScript

const url = new URL(
  'https://prod-api.superfone.co.in/superfone/enterprise/api/source-type'
);
url.searchParams.set('page', '1');
url.searchParams.set('page_size', '50');

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/source-type',
    headers={'x-api-key': os.environ['SF_API_KEY']},
    params={'page': 1, 'page_size': 50}
)
print(response.json()['data'])

Success Response

Status Code: 200 OK

{
  "data": {
    "rows": [
      { "id": 1, "title": "CSV_UPLOAD" },
      { "id": 2, "title": "FACEBOOK_INTEGRATION" },
      { "id": 3, "title": "PHONE_CONTACT" },
      { "id": 4, "title": "WHATSAPP_MESSAGE" },
      { "id": 5, "title": "WHATSAPP_INTEGRATION" },
      { "id": 6, "title": "PABBLY" },
      { "id": 7, "title": "OTHERS" }
    ],
    "total_pages": 1,
    "current_page": 1,
    "page_size": 50,
    "total_items": 7
  },
  "message": "success"
}

Response Fields

Field	Type	Description
data.rows[].id	number	Internal source type ID
data.rows[].title	string	Source type name — this is the value to pass as source_type in the upsert-lead request
data.total_pages	number	Total pages available
data.current_page	number	Page number returned
data.page_size	number	Items per page
data.total_items	number	Total matching source types across all pages

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 value as source_type