List contact list numbers

GET/v1/accounts/{accountId}/contactLists/{contactListId}/numbers

Returns the numbers of a contact list, optionally filtered and sorted.

Path parameters

accountIduuidRequired

ID of your SIP Caller account. See Account ID.

contactListIduuidRequired

ID of the contact list.

Query parameters

filterJSON object

Conditions that the records must match, such as {"name":"sales"}. See the Filter fields below, and Filter for the syntax.

sortJSON array

Field and direction used to sort the records, such as ["id","DESC"]. Defaults to ["id","ASC"]. See Sort.

rangeJSON array

Zero-based positions of the first and last records to return, both included, such as [0,99]. Defaults to [0,9]. See Pagination.

Filter fields

Fields that can be used in the filter query parameter. See Filter for the general syntax.

numberstring

Numbers that contain the text, which allows partial lookups.

Example: {"number":"18035551"}
varValuesobject

Numbers whose variable contains the text (case-insensitive). The key is $ followed by the position of the variable, starting at 1.

Example: {"varValues":{"$1":"watson"}}

Sort fields

Fields that can be used in the sort query parameter, in ascending (ASC) or descending (DESC) order. See Sort for the general syntax. When sort is omitted, results are sorted by id in ascending order.

idnumber

Returns

Returns an array of contact list number objects for the requested page. The X-Total-Count and Content-Range headers contain the total number of records matching the filter, for example Content-Range: contactListNumbers 0-9/57. See Pagination.

GET

/v1/accounts/ACCOUNT_ID/contactLists/CONTACT_LIST_ID/numbers

curl -G 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/contactLists/CONTACT_LIST_ID/numbers' \ -H 'Authorization: Bearer API_KEY_TOKEN' \ --data-urlencode 'filter={"number":"18035551"}' \ --data-urlencode 'sort=["id","DESC"]' \ --data-urlencode 'range=[0,99]'

Response

200 OK

[ { "id": 8, "number": "+18035551005", "varValues": [ "Millie Watson", "$118.49" ] }, { "id": 7, "number": "+18035551004", "varValues": [ "Stefan Robertson", "$99.00" ] }, { "id": 6, "number": "+18035551003", "varValues": [ "Clara White", "$350.00" ] } ]


SIP Caller
© 2026 Easy Caller LLC All Rights Reserved
LinkedinYou Tube
Trustpilot