Are you a cracked engineer? See your Vamo profile
vamo

List contact notes

GET https://api.vamotalent.ai/v2/contacts/{contactId}/notes
Access
Authenticated
contact:read
Cost
Free
Rate limit
120 / minute per account
Quota
None

The notes your account keeps about one person, newest first, each with who wrote it and when, and who last edited it. Page with limit, and pass each nextCursor back as cursor until it is null. A deleted note is left out. The contact list carries noteCount and latestNote for each person, so read this only for the people whose notes you need.

Path parameters

  • contactId string required
    max 16 chars

Query parameters

  • limit integer default: 50

    How many notes to return, 1 to 100.

    min 1, max 100
  • cursor string

    The `nextCursor` from the page before, to read the next, older page. Omit it for the newest notes.

    max 256 chars

Responses

A page of notes, newest first

  • notes array of ContactNote required

    This page of notes, newest first.

    • id string required

      The note id.

    • contactId string required

      The contact the note is about.

    • body string required

      The note text, as written.

    • author NoteAuthor required

      Who wrote a note, or who last edited it.

      • kind string required

        What wrote the note: `member` is a person on the account, `key` is an API key, `tool` is an AI tool a person signed in, and `system` is Vamo.

        memberkeytoolsystem
      • id string | null required

        The id of that member, key or tool connection. Null for `system`.

      • name string | null required

        What to call them: the person’s name for a member, the key’s label for a key, the tool’s name for a tool, and `Vamo` for `system`. Null when no name is held.

    • createdAt string required

      When the note was written, as an ISO 8601 instant.

    • updatedAt string | null required

      When the note was last edited, as an ISO 8601 instant. Null when it was never edited.

    • editedBy object required
      • kind string required

        What wrote the note: `member` is a person on the account, `key` is an API key, `tool` is an AI tool a person signed in, and `system` is Vamo.

        memberkeytoolsystem
      • id string | null required

        The id of that member, key or tool connection. Null for `system`.

      • name string | null required

        What to call them: the person’s name for a member, the key’s label for a key, the tool’s name for a tool, and `Vamo` for `system`. Null when no name is held.

  • nextCursor string | null required

    Pass it back as `cursor` to read the next, older page. Null on the last page. Do not parse or construct it.

vamo

© 2026 Vamo Holdings, Inc.