Naar hoofdinhoud gaan
GET
Contacten ophalen
Geeft de opgeslagen contacten terug uit de workspace die bij je API-sleutel hoort. Concepten van scans worden pas meegenomen nadat iemand ze heeft opgeslagen.

De volgorde kiezen

Gebruik bijvoorbeeld /contacts?sort=updatedAt&limit=25&offset=0 om bijgewerkte contacten op te halen.
sort=updatedAt slaat contacten over die nog nooit zijn bijgewerkt. Gebruik createdAt als je de volledige contactlijst nodig hebt.

Meer contacten ophalen

Elk antwoord bevat data en pagination. Gebruik limit en offset om de volgende pagina op te halen zolang pagination.hasMore de waarde true heeft. Voorbeeld van paginering Het antwoord bevat contactgegevens, tags, ingediende berichten, interne notities en het toegewezen teamlid. updatedAt is null totdat een contact is bijgewerkt.

Autorisaties

Authorization
string
header
vereist

API-sleutel die is gemaakt via Instellingen → API-sleutels.

Queryparameters

limit
integer
standaard:100

Maximaal aantal items per pagina. Waarden worden begrensd op 1–100; bij een ontbrekend of ongeldig getal wordt 100 gebruikt.

Vereist bereik: 1 <= x <= 100
offset
integer
standaard:0

Aantal items dat vóór deze pagina wordt overgeslagen. Negatieve waarden worden 0; bij een ontbrekend of ongeldig getal wordt 0 gebruikt.

Vereist bereik: x >= 0
sort
enum<string>
standaard:createdAt

createdAt geeft alle opgeslagen contacten terug. updatedAt geeft alleen contacten terug waarvan updatedAt niet null is. Beide tonen de nieuwste eerst.

Beschikbare opties:
createdAt,
updatedAt

Respons

Een lijst met contacten, verdeeld over pagina's

data
object[]
vereist
pagination
object
vereist

Informatie om door een lijst met resultaten te bladeren.