Are you a cracked engineer? See your Vamo profile
vamo

List shortlists

GET https://api.vamotalent.ai/v2/shortlists
Access
Authenticated
shortlist:read
Cost
Free
Rate limit
60 / minute per account
Quota
None

Your account shortlists with derived member counts. Excludes archived unless archived=true.

Query parameters

  • limit integer default: 25
    min 1, max 250
  • offset integer | null default: 0
    min 0, max 100000
  • archived string
    truefalse
  • pinned string
    truefalse

Responses

The shortlists

  • rows array of Shortlist required

    This page of shortlists.

    • id string required

      The shortlist id.

    • name string required

      The list name.

    • kind string required

      What kind of list this is: `project` for a list linked to a project you can read, `freestanding` for every other list. Seeing `project` needs project:read: without it a list linked to a project reads `freestanding` like any other. An API key or a connected AI client does not hold project:read.

      freestandingprojectpipeline
    • description string | null required

      Free-text description. Null when none.

    • ownerId string | null required

      The member or API key that owns the list, as an actor id. Null when it has no individual owner.

    • pinned boolean required

      Whether the list is pinned for quick access.

    • archivedAt string | null required

      When the list was archived, as an ISO 8601 instant. An archived list is hidden from the default listing but keeps its members and sequences. Null while active.

    • createdAt string required

      When the list was created, as an ISO 8601 instant.

    • agentId string | null required

      The managed agent that owns this list, when one does. The list is yours either way; this only says who keeps it up to date.

    • stats object required

      Member and sequence counts for this list.

      • members integer required

        How many contacts are on this list.

      • sequences integer required

        How many outreach sequences are attached to it.

  • total integer required

    How many shortlists match the filters in total, not just on this page.

vamo

© 2026 Vamo Holdings, Inc.