jolvAPI
jolv.app Open Jolv
API reference / Contacts & calendar

Contacts (organisation)

Lists the contacts of the whole organisation or of a company (name, title, category, e-mail, phone, LinkedIn, board mandate). `updated_since` keeps only contacts created since that date; cursor pagination (`limit`, `cursor` → `next_cursor`). Read-only.

GET/v1/list_contacts

Query parameters

  • company_iduuidoptional
    Company UUID (optional; otherwise the whole organisation).
  • role_typestringoptional
    Filter by contact category (optional; e.g. executive, board, advisor).
  • updated_sincestringoptional
    Only return items created or modified since this date (YYYY-MM-DD or ISO 8601 timestamp, optional).
  • limitintegeroptional
    Maximum number of contacts per page (default 100, max 200).
  • cursorstringoptional
    Pagination cursor returned by the previous call (next_cursor), optional.

Response

Status 200, application/json. Resources outside your rights are absent, never an error.

  • contactsobject[]
    Show child attributes
    • idstring
    • company_idstring · nullable
    • namestring
    • rolestring · nullable
      Category (executive, board member…)
    • titlestring · nullable
      Role
    • emailstring · nullable
    • phonestring · nullable
    • linkedinstring · nullable
    • companystring · nullable
    • boardobject
      Board mandate at the company.
      Show child attributes
      • seatstring · nullable
        Board seat (chair, member, observer…).
      • representsstring · nullable
        Entity represented on the board.
      • mandate_startstring · nullable
      • mandate_endstring · nullable
      • votingboolean · nullable
        Voting right on the board.
    • created_atstring · nullable
  • next_cursorstring · nullable

Errors

400 invalid parameter · 401 missing or expired token · 429 too many requests · 500 read failed. See Errors.