Lista list kontaktów
/v1/accounts/{accountId}/contactListsZwraca listy kontaktów konta, opcjonalnie przefiltrowane i posortowane.
Parametry ścieżki
ID Twojego konta SIP Caller. Zobacz ID konta.
Parametry zapytania
Warunki, które muszą spełniać rekordy, na przykład {"name":"sales"}. Zobacz Pola filtra poniżej oraz Filtrowanie, aby poznać składnię.
Pole i kierunek sortowania rekordów, na przykład ["name","DESC"]. Domyślnie ["name","ASC"]. Zobacz Sortowanie.
Liczone od zera pozycje pierwszego i ostatniego zwracanego rekordu, obie włącznie, na przykład [0,99]. Domyślnie [0,9]. Zobacz Paginacja.
Pola filtra
Pola, których można używać w parametrze zapytania filter. Ogólną składnię opisano w sekcji Filtrowanie.
Listy kontaktów o dowolnym z podanych ID.
{"ids":["CONTACT_LIST_ID_1","CONTACT_LIST_ID_2"]}Listy kontaktów, których nazwa zawiera podany tekst (bez rozróżniania wielkości liter).
{"name":"overdue"}Pola sortowania
Pola, których można używać w parametrze zapytania sort, w kolejności rosnącej (ASC) lub malejącej (DESC). Ogólną składnię opisano w sekcji Sortowanie. Gdy parametr sort zostanie pominięty, wyniki są sortowane rosnąco według pola name.
namenumbersCountZwraca
Zwraca tablicę obiektów listy kontaktów dla żądanej strony. Nagłówki X-Total-Count i Content-Range zawierają całkowitą liczbę rekordów pasujących do filtra, na przykład Content-Range: contactLists 0-9/57. Zobacz Paginacja.
/v1/accounts/ACCOUNT_ID/contactLists
curl -G 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/contactLists' \
-H 'Authorization: Bearer API_KEY_TOKEN' \
--data-urlencode 'filter={"name":"overdue"}' \
--data-urlencode 'sort=["name","ASC"]' \
--data-urlencode 'range=[0,99]'Odpowiedź
200 OK
[
{
"id": "019ffc4b-1c59-72ed-b15a-cbf81a2b95d9",
"name": "Overdue Accounts",
"numbersCount": 1255,
"varNames": [
"Customer Name",
"Due Balance"
],
"updatedAt": "2026-08-13T18:03:28.729"
}
]
