Vessel

Vessel Lists API

The lists API from Vessel — 2 operation(s) for lists.

Documentation GitHub OpenAPI

Operations 2

GET /crm/lists Get All Lists #

GET /crm/list Get List #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/vessel-lists-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: CRM API Reference Lists API
  version: '2.0'
  summary: API
servers:
- url: https://api.vessel.dev
security:
- VesselAPIToken: []
tags:
- name: lists
paths:
  /crm/lists:
    get:
      summary: Get All Lists
      tags:
      - lists
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                title: responseBody
                type: object
                properties:
                  lists:
                    type: array
                    items:
                      $ref: '#/components/schemas/ListWithoutAssociations'
                  nextPageCursor:
                    type: string
              examples:
                example-1:
                  value:
                    lists:
                    - id: 006b4db16b6b50c981a174b02753c390
                      nativeId: '34'
                      name: California Leads
                      modifiedTime: '2019-08-24T14:15:22Z'
                      createdTime: '2019-08-24T14:15:22Z'
                    nextPageCursor: string
      operationId: get-all-crm-lists
      description: Retrieve all Lists
      parameters:
      - schema:
          type: string
        in: query
        name: accessToken
        description: The token for the customer's CRM account. This was generated when they connected their account.
        required: true
      - schema:
          type: string
          enum:
          - contact
          - lead
        in: query
        name: objectType
        description: The object type for the Lists
        required: true
      - schema:
          type: string
        in: query
        name: cursor
      - schema:
          type: boolean
        in: query
        name: allFields
        description: Returns all fields including non-unifiable and custom fields under the "additional" property in the response
  /crm/list:
    get:
      summary: Get List
      tags:
      - lists
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                title: responseBody
                type: object
                properties:
                  list:
                    $ref: '#/components/schemas/ListWithAssociations'
                  nextPageCursor:
                    type: string
              examples:
                example-1:
                  value:
                    list:
                    - id: 006b4db16b6b50c981a174b02753c390
                      nativeId: '34'
                      name: California Leads
                      modifiedTime: '2019-08-24T14:15:22Z'
                      createdTime: '2019-08-24T14:15:22Z'
                      associations:
                      - contactIds:
                        - v.contact.e5f32d4fd2115220bd20a2ccf81210ec
                        - v.contact.2d20a2ccf81210ecddf32d4fd2115221
                    nextPageCursor: string
      operationId: get-one-crm-list
      parameters:
      - schema:
          type: string
        in: query
        name: accessToken
        description: The token for the customer's CRM account. This was generated when they connected their account.
        required: true
      - schema:
          type: string
          enum:
          - contact
          - lead
        in: query
        name: objectType
        description: The object type for the Lists
        required: true
      - schema:
          type: string
        in: query
        name: id
        required: true
      - schema:
          type: string
        in: query
        name: cursor
        description: Provide the `nextPageCursor` value from the previous request to retrieve the next set of ids
      - schema:
          type: boolean
        in: query
        name: allFields
        description: Returns all fields including non-unifiable and custom fields under the "additional" property in the response
      description: Retrieve a single List by Id
components:
  schemas:
    ListWithoutAssociations:
      title: List
      type: object
      description: A List or View in a CRM
      properties:
        id:
          type: string
          description: Id of the object.
        nativeId:
          type: string
          description: Id of the object in the connected CRM.
        name:
          type: string
          description: The name of the list
        createdTime:
          type: string
          description: The timestamp that the list was created
        modifiedTime:
          type: string
          description: The timestamp the list was last modified
        additional:
          type: object
          description: Returned when `allFields` is set in the query params. Includes all data, untransformed, we received from the downstream CRM
      required:
      - id
      - nativeId
      - name
      - createdTime
      - modifiedTime
    ListWithAssociations:
      title: List
      type: object
      description: A List or View in a CRM
      properties:
        id:
          type: string
          description: Id of the object.
        nativeId:
          type: string
          description: Id of the object in the connected CRM.
        name:
          type: string
          description: The name of the list
        createdTime:
          type: string
          description: The timestamp that the list was created
        modifiedTime:
          type: string
          description: The timestamp the list was last modified
        associations:
          type: object
          required:
          - contactIds
          - leadIds
          - ownerUserId
          properties:
            contactIds:
              type: array
              items:
                type: string
            leadIds:
              type: array
              items:
                type: string
            ownerUserId:
              type: string
              description: The Id of the User that owns this list
        additional:
          type: object
          description: Returned when `allFields` is set in the query params. Includes all data, untransformed, we received from the downstream CRM
      required:
      - id
      - nativeId
      - name
      - createdTime
      - modifiedTime
      - associations
  securitySchemes:
    VesselAPIToken:
      name: vessel-api-token
      type: apiKey
      in: header

Vessel Lists API

Operations 2

Documentation

Specifications

SDKs

Other Resources