Live Direct Marketing

Live Direct Marketing Company Lists API

The Company Lists API from Live Direct Marketing — 7 operation(s) for company lists.

GitHub OpenAPI

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/company-lists List company lists · List all company lists for the tenant #
Ask an LLM
“Which company lists do I have in my workspace?”
“Can I see all my saved account lists?”
Tell an agent
List all my company lists.
Show every company list in this tenant.
POST /api/company-lists Create a company list · Create a new company list #
Ask an LLM
“How do I create a new list to group target companies?”
“Can I make a smart company list driven by filters?”
Tell an agent
Create a company list named {name}.
Create a smart company list {name} with filters {smartFilters}.
GET /api/company-lists/contacts-counts Count contacts behind each company list · Sum of contacts of member companies, per list id (?ids=csv) #
Ask an LLM
“How many contacts belong to the companies in each of my lists?”
“Can I get contact totals for several company lists in one call?”
Tell an agent
Count contacts of member companies for lists {ids}.
Show contact totals per company list for {ids}.
PATCH /api/company-lists/{id} Update a company list · Update a company list #
Ask an LLM
“Can I rename a company list or pin it to the top?”
“Is it possible to move a company list into a different group?”
Tell an agent
Rename company list {id} to {name}.
Move company list {id} into group {groupId}.
DELETE /api/company-lists/{id} Delete a company list · Delete a company list #
Ask an LLM
“Can I delete a company list I no longer use?”
“Does deleting a company list remove the companies themselves?”
Tell an agent destructive · confirm first
Delete company list {id}.
Remove the company list {id}.
POST /api/company-lists/reorder Reorder company lists · Reorder company lists by id/sortOrder array #
Ask an LLM
“Can I change the order my company lists appear in?”
“What does it take to set a custom sort order on my lists?”
Tell an agent
Reorder my company lists as {items}.
Apply sort order {items} to company lists.
POST /api/company-lists/{id}/companies Add companies to a list · Add companies to a list #
Ask an LLM
“How do I put specific companies into one of my lists?”
“Can I add several companies to a list at once?”
Tell an agent
Add companies {companyIds} to list {id}.
Put {companyIds} into company list {id}.
DELETE /api/company-lists/{id}/companies Remove companies from a list · Remove companies from a list #
Ask an LLM
“Can I take companies out of a list without deleting them?”
“What happens to companies removed from a company list?”
Tell an agent destructive · confirm first
Remove companies from list {id}.
Take member companies out of company list {id}.
POST /api/company-lists/{id}/merge Merge one company list into another · Merge this list into another list: move or copy all member companies… #
Ask an LLM
“Can I fold one company list into another, either moving or copying its companies?”
“What happens to duplicate companies when lists are merged?”
Tell an agent
Merge company list {id} into {targetId} using mode {mode}.
Copy all companies from list {id} into list {targetId}, setting mode to {mode}.
POST /api/company-lists/{id}/duplicate Duplicate a company list · Duplicate a company list #
Ask an LLM
“Can I make a copy of an existing company list?”
“Is there a quick way to clone a list before editing it?”
Tell an agent
Duplicate company list {id}.
Clone the company list {id}.

Documentation

📖
Documentation
https://developers.live-direct-marketing.online/
📖
APIReference
https://developers.live-direct-marketing.online/api-reference
📖
GettingStarted
https://developers.live-direct-marketing.online/quickstart
📖
Authentication
https://developers.live-direct-marketing.online/authentication
📖
Documentation
https://check.live-direct-marketing.online/docs
📖
APIReference
https://check.live-direct-marketing.online/api/docs

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/live-direct-marketing-online/refs/heads/main/openapi/live-direct-marketing-online-company-lists-api-openapi.yml

Other Resources

🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/live-direct-marketing-online/refs/heads/main/data-model/live-direct-marketing-online-data-model.yml

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/live-direct-marketing-online:live-direct-marketing-online-company-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

live-direct-marketing-online-company-lists-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: LDM v3 Company Lists API
  description: 'Multi-tenant B2B outreach automation platform. Auth: JWT Bearer (15-min) or tenant API key (ldm_*) managed in CRM Settings → API Keys. All tenant-scoped endpoints require the X-Tenant-Id header.'
  version: 1.0.0
  contact: {}
servers:
- url: https://api.live-direct-marketing.online
  description: Production
- url: https://api.dev.live-direct-marketing.online
  description: Development
- url: http://127.0.0.1:3000
  description: Local
tags:
- name: Company Lists
paths:
  /api/company-lists:
    get:
      operationId: CompanyListsController_findAll
      parameters:
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: List all company lists for the tenant
      tags:
      - Company Lists
    post:
      operationId: CompanyListsController_create
      parameters:
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CompanyListsCreateDto'
      responses:
        '201':
          description: ''
      security:
      - jwt: []
      summary: Create a new company list
      tags:
      - Company Lists
  /api/company-lists/contacts-counts:
    get:
      operationId: CompanyListsController_contactsCounts
      parameters:
      - name: ids
        required: true
        in: query
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: Sum of contacts of member companies, per list id (?ids=csv)
      tags:
      - Company Lists
      x-required-scope:
      - crm:read
  /api/company-lists/{id}:
    patch:
      operationId: CompanyListsController_update
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CompanyListsUpdateDto'
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: Update a company list
      tags:
      - Company Lists
    delete:
      operationId: CompanyListsController_remove
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: Delete a company list
      tags:
      - Company Lists
  /api/company-lists/reorder:
    post:
      operationId: CompanyListsController_reorder
      parameters:
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CompanyListsReorderDto'
      responses:
        '201':
          description: ''
      security:
      - jwt: []
      summary: Reorder company lists by id/sortOrder array
      tags:
      - Company Lists
      x-required-scope:
      - crm:write
  /api/company-lists/{id}/companies:
    post:
      operationId: CompanyListsController_addCompanies
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CompanyListsAddCompaniesDto'
      responses:
        '201':
          description: ''
      security:
      - jwt: []
      summary: Add companies to a list
      tags:
      - Company Lists
    delete:
      operationId: CompanyListsController_removeCompanies
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: Remove companies from a list
      tags:
      - Company Lists
  /api/company-lists/{id}/merge:
    post:
      operationId: CompanyListsController_merge
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CompanyListsMergeDto'
      responses:
        '201':
          description: ''
      security:
      - jwt: []
      summary: 'Merge this list into another list: move or copy all member companies…'
      tags:
      - Company Lists
  /api/company-lists/{id}/duplicate:
    post:
      operationId: CompanyListsController_duplicate
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      responses:
        '201':
          description: ''
      security:
      - jwt: []
      summary: Duplicate a company list
      tags:
      - Company Lists
components:
  schemas:
    CompanyListsMergeDto:
      type: object
      properties:
        targetId:
          type: string
          description: Id of the list to merge member companies into
        mode:
          type: string
          description: 'move: relocate companies to targetId; copy: keep them in both lists'
          enum:
          - move
          - copy
      required:
      - targetId
      - mode
    CompanyListsAddCompaniesDto:
      type: object
      properties:
        companyIds:
          type: array
          items:
            type: string
      required:
      - companyIds
    CompanyListsUpdateDto:
      type: object
      properties:
        name:
          type: string
        description:
          type: string
        color:
          type: string
        icon:
          type: string
        type:
          type: string
        smartFilters:
          type: object
          description: 'SMART lists only: explicit versioned native company filters. STATIC lists leave this unset.'
          example:
            version: 1
            filterRules:
            - field: industry
              operator: contains
              value: SaaS
        isPinned:
          type: boolean
        groupId:
          type:
          - object
          - 'null'
    CompanyListsReorderItemDto:
      type: object
      properties:
        id:
          type: string
        sortOrder:
          type: number
      required:
      - id
      - sortOrder
    CompanyListsReorderDto:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/CompanyListsReorderItemDto'
      required:
      - items
    CompanyListsCreateDto:
      type: object
      properties:
        name:
          type: string
        description:
          type: string
        color:
          type: string
        icon:
          type: string
        type:
          type: string
        smartFilters:
          type: object
          description: 'SMART lists only: explicit versioned native company filters. STATIC lists leave this unset.'
          example:
            version: 1
            filterRules:
            - field: industry
              operator: contains
              value: SaaS
        isPinned:
          type: boolean
        groupId:
          type:
          - object
          - 'null'
      required:
      - name
  securitySchemes:
    jwt:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: JWT access token from /auth/login (Bearer <token>)
    tenant-api-key:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Tenant API key (Bearer ldm_*) for MCP/A2A clients. Issued via CRM Settings → API Keys.
    rpa-service:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Dedicated RPA service key. No tenant API-key or query-key authentication.