DKBSignDocs

API reference

GETRequires Bearer token

List contacts

/api/contacts

Address book for the caller. scope is mine, org, or all (default). Emails and phones are normalized. Returns a ContactOut[] array (id, owner_user_id, org_id, visibility, names, email, phone, title, company, source, source_uid, extra, timestamps).

Path parameters

This endpoint has no path parameters.

Query parameters

FieldTypeDescription
q
stringSearch name, email, or company.
e.g. "ada"
source
stringFilter by source: manual, csv, ldap, google, outlook.
e.g. "csv"
visibility
stringprivate or org.
e.g. "private"
scope
stringmine, org, or all (default).
e.g. "all"
limit
integerPage size (1–200, default 50).
e.g. 50
offset
integerOffset (default 0).
e.g. 0

Request body

This endpoint does not accept a request body.

Responses

StatusMeaning
200Contacts
401Missing or invalid Bearer token.

Request

curl
curl -X GET 'https://api.dkbsigns.com/api/contacts?q=ada&source=csv&visibility=private&scope=all&limit=50&offset=0' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN'

Response 200

json
[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "owner_user_id": "4",
    "org_id": "1",
    "visibility": "private",
    "first_name": "Ada",
    "last_name": "Kouassi",
    "full_name": "Ada Kouassi",
    "email": "ada@acme.test",
    "phone": "+2250700000001",
    "title": "CFO",
    "company": "ACME",
    "source": "manual",
    "source_uid": null,
    "extra": {},
    "created_at": "2026-03-01T10:00:00Z",
    "updated_at": "2026-03-01T10:00:00Z"
  }
]