The Bounces API from listmonk — 2 operation(s) for bounces.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/listmonk-bounces-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Listmonk Bounces API
version: '1.0'
description: 'Operations tagged Bounces across 2 of this provider''s published API definitions: listmonk-collections-openapi.yml, listmonk-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- description: Listmonk Developement Server
url: http://localhost:9000/api
- url: '{host}/api'
description: Self-hosted instance
variables:
host:
default: http://localhost:9000
description: Base URL of your listmonk instance
tags:
- name: Bounces
description: Bounce API
paths:
/bounces:
get:
description: handles retrieval of bounce records.
operationId: getBounces
tags:
- Bounces
parameters:
- in: query
name: campaign_id
description: Numeric identifier for retrieving bounce records associated with a specific campaign
schema:
type: integer
- in: query
name: page
description: Page number for paginated results. Start from 1 for the first page
schema:
type: integer
- in: query
name: per_page
description: Number of items per page. Use an integer for specific page size or 'all' to retrieve all results
schema:
oneOf:
- type: integer
description: Number of items to return per page
- type: string
enum:
- all
description: Return all results without pagination
- in: query
name: source
description: Filter bounce records by their source of origin
schema:
type: string
- in: query
name: order_by
description: Specifies the field by which to sort the bounce records. Available options are 'email', 'campaign_name', 'source', and 'created_at'
schema:
type: string
enum:
- email
- campaign_name
- source
- created_at
- in: query
name: order
description: Determines the sort order of results. Use 'asc' for ascending or 'desc' for descending order
schema:
type: string
enum:
- asc
- desc
responses:
'200':
description: list of bounce records
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
results:
type: array
items:
$ref: '#/components/schemas/Bounce'
query:
type: string
total:
type: integer
per_page:
type: integer
page:
type: integer
delete:
description: handles deletion of bounce records.
operationId: deleteBounces
tags:
- Bounces
parameters:
- in: query
name: all
description: flag for multiple bounce record deletion
schema:
type: boolean
- in: query
name: id
description: list of bounce ids to delete
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
data:
type: boolean
servers:
- description: Listmonk Developement Server
url: http://localhost:9000/api
/bounces/{id}:
get:
description: handles retrieval of bounce record by id
operationId: getBounceById
parameters:
- in: path
name: id
required: true
description: The id value of the bounce you want to retreive.
schema:
type: integer
tags:
- Bounces
responses:
'200':
description: bounce object
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/Bounce'
delete:
description: handles bounce deletion, either a single one (ID in the URI), or a list.
operationId: deleteBounceById
parameters:
- in: path
name: id
required: true
description: The id value of the bounce you want to delete.
schema:
type: integer
tags:
- Bounces
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
data:
type: boolean
servers:
- description: Listmonk Developement Server
url: http://localhost:9000/api
/bounces/{bounce_id}:
delete:
operationId: deleteBounce
tags:
- Bounces
summary: Delete a single bounce record.
parameters:
- name: bounce_id
in: path
required: true
schema:
type: integer
responses:
'200':
description: Deletion result.
security:
- BasicAuth: []
- TokenAuth: []
servers:
- url: http://localhost:9000/api
description: Default local self-hosted instance
- url: '{host}/api'
description: Self-hosted instance
variables:
host:
default: http://localhost:9000
description: Base URL of your listmonk instance
components:
schemas:
Bounce:
type: object
properties:
results:
type: array
items:
type: object
properties:
id:
type: integer
type:
type: string
source:
type: string
meta:
type: object
created_at:
type: string
email:
type: string
subscriber_uuid:
type: string
subscriber_id:
type: integer
campaign:
type: object
properties:
id:
type: integer
name:
type: string
campaign_uuid:
type: string
total:
type: integer
Bounce_2:
type: object
properties:
id:
type: integer
type:
type: string
enum:
- hard
- soft
- complaint
source:
type: string
subscriber_id:
type: integer
campaign_id:
type: integer
email:
type: string
created_at:
type: string
format: date-time
BouncesResponse:
type: object
properties:
data:
type: object
properties:
results:
type: array
items:
$ref: '#/components/schemas/Bounce_2'
total:
type: integer
securitySchemes:
BasicAuth:
type: http
scheme: basic
description: HTTP Basic auth using an API user name and token (api_user:token).
TokenAuth:
type: apiKey
in: header
name: Authorization
description: 'Authorization header in the form: token api_user:token.'
x-refined-from:
- listmonk-collections-openapi.yml
- listmonk-openapi.yml