Live Direct Marketing

Live Direct Marketing Suppression API

The Suppression API from Live Direct Marketing — 6 operation(s) for suppression.

GitHub OpenAPI

Operations 8

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/suppression List suppressed email addresses · List suppressed emails #
Ask an LLM
“Which email addresses are on my do-not-send suppression list?”
“Can I filter suppressed emails by the reason they were suppressed?”
Tell an agent
List suppressed emails with reason {reason}.
Search the email suppression list for {search}, page {page} of {limit}.
POST /api/suppression Suppress a single email address · Add an email to the suppression list #
Ask an LLM
“How do I stop all sending to one specific email address?”
“Can I add an individual person to the suppression list?”
Tell an agent
Add an email address to the suppression list.
Suppress one recipient so we never email them.
POST /api/suppression/bulk Bulk-add emails to the suppression list · Bulk-add emails to the suppression list #
Ask an LLM
“Can I upload many email addresses to the suppression list in one request?”
“Is there a bulk way to suppress a batch of unsubscribes?”
Tell an agent
Bulk-add these email addresses to the suppression list.
Suppress a batch of emails at once.
POST /api/suppression/check Check emails against the suppression list · Check a batch of emails against the suppression list #
Ask an LLM
“Before a send, can I check which of these emails are suppressed?”
“Which addresses in my batch are blocked from sending?”
Tell an agent
Check emails {emails} against the suppression list.
Tell me which of {emails} are suppressed.
DELETE /api/suppression/{email} Remove an email from the suppression list · Remove an email from the suppression list #
Ask an LLM
“Can I take an email address off the suppression list so they can be emailed again?”
“What if someone was suppressed by mistake?”
Tell an agent destructive · confirm first
Remove {email} from the suppression list.
Unsuppress email address {email}.
GET /api/suppression/domains List suppressed domains · List suppressed domains #
Ask an LLM
“Which whole domains are blocked from receiving my emails?”
“Can I search my suppressed domains by name?”
Tell an agent
Search suppressed domains for {search}.
List suppressed domains, page {page} with {limit} per page.
POST /api/suppression/domains Suppress an entire domain · Add a domain to the suppression list #
Ask an LLM
“Can I block sending to every address at a particular domain?”
“How do I add a company domain to the suppression list?”
Tell an agent
Add a domain to the suppression list.
Suppress every address at a domain.
DELETE /api/suppression/domains/{domain} Remove a domain from the suppression list · Remove a domain from the suppression list #
Ask an LLM
“Can I unblock a domain I suppressed earlier?”
“What happens to sending once I remove a domain suppression?”
Tell an agent destructive · confirm first
Remove domain {domain} from the suppression list.
Unsuppress the domain {domain}.

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-suppression-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-suppression-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-suppression-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: LDM v3 Suppression 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: Suppression
paths:
  /api/suppression:
    get:
      operationId: SuppressionController_list
      parameters:
      - name: page
        required: true
        in: query
        schema:
          type: string
      - name: limit
        required: true
        in: query
        schema:
          type: string
      - name: reason
        required: true
        in: query
        schema:
          type: string
      - name: search
        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: List suppressed emails
      tags:
      - Suppression
    post:
      operationId: SuppressionController_add
      parameters:
      - 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: Add an email to the suppression list
      tags:
      - Suppression
  /api/suppression/bulk:
    post:
      operationId: SuppressionController_addBulk
      parameters:
      - 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: Bulk-add emails to the suppression list
      tags:
      - Suppression
      x-required-scope:
      - suppression:write
  /api/suppression/check:
    post:
      operationId: SuppressionController_check
      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/CheckEmailsDto'
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: Check a batch of emails against the suppression list
      tags:
      - Suppression
      x-required-scope:
      - suppression:read
  /api/suppression/{email}:
    delete:
      operationId: SuppressionController_remove
      parameters:
      - name: email
        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 an email from the suppression list
      tags:
      - Suppression
  /api/suppression/domains:
    get:
      operationId: SuppressionController_listDomains
      parameters:
      - name: page
        required: true
        in: query
        schema:
          type: string
      - name: limit
        required: true
        in: query
        schema:
          type: string
      - name: search
        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: List suppressed domains
      tags:
      - Suppression
      x-required-scope:
      - suppression:read
    post:
      operationId: SuppressionController_addDomain
      parameters:
      - 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: Add a domain to the suppression list
      tags:
      - Suppression
      x-required-scope:
      - suppression:write
  /api/suppression/domains/{domain}:
    delete:
      operationId: SuppressionController_removeDomain
      parameters:
      - name: domain
        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 a domain from the suppression list
      tags:
      - Suppression
components:
  schemas:
    CheckEmailsDto:
      type: object
      properties:
        emails:
          minItems: 1
          type: array
          items:
            type: string
      required:
      - emails
  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.