addy.io Blocklist API
The Blocklist API from addy.io — 4 operation(s) for blocklist.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/addy-io:addy-io-blocklist-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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: addy.io API Documentation Blocklist API
description: ''
version: 1.0.0
servers:
- url: https://app.addy.io
security:
- default: []
tags:
- name: Blocklist
description: ''
paths:
/api/v1/blocklist:
get:
summary: Get All Blocklist Entries
operationId: getAllBlocklistEntries
description: This endpoint retrieves all blocklist entries.
parameters:
- in: query
name: filter[search]
description: Search blocklist entries by email or domain.
example: example.com
required: false
schema:
type: string
description: Search blocklist entries by email or domain.
example: example.com
- in: query
name: filter[type]
description: 'Filter blocklist entries by type. Options: email, domain.'
example: email
required: false
schema:
type: string
description: 'Filter blocklist entries by type. Options: email, domain.'
example: email
- in: query
name: sort
description: 'Sort by field, prepend "-" for descending. Options: created_at, value, blocked, last_blocked.'
example: -created_at
required: false
schema:
type: string
description: 'Sort by field, prepend "-" for descending. Options: created_at, value, blocked, last_blocked.'
example: -created_at
- in: query
name: page[number]
description: Paginate the blocklist results.
example: 1
required: false
schema:
type: integer
description: Paginate the blocklist results.
example: 1
- in: query
name: page[size]
description: Paginate the blocklist results, default 100, min 1 max 100.
example: 10
required: false
schema:
type: integer
description: Paginate the blocklist results, default 100, min 1 max 100.
example: 10
- in: header
name: X-Requested-With
description: ''
example: XMLHttpRequest
schema:
type: string
responses:
200:
description: ''
content:
application/json:
schema:
type: object
example:
data:
- id: 8bff51ba-1917-466f-8f54-641a9e711eb8
user_id: ca0a4e09-c266-4f6f-845c-958db5090f09
value: spam@example.com
type: email
blocked: 4
last_blocked: '2019-10-01 09:00:00'
created_at: '2019-10-01 09:00:00'
updated_at: '2019-10-01 09:00:00'
- id: 0ad7a75a-1517-4b86-bb8a-9443d4965e60
user_id: ca0a4e09-c266-4f6f-845c-958db5090f09
value: example.com
type: domain
blocked: 0
last_blocked: null
created_at: '2019-10-01 09:00:00'
updated_at: '2019-10-01 09:00:00'
properties:
data:
type: array
example:
- id: 8bff51ba-1917-466f-8f54-641a9e711eb8
user_id: ca0a4e09-c266-4f6f-845c-958db5090f09
value: spam@example.com
type: email
blocked: 4
last_blocked: '2019-10-01 09:00:00'
created_at: '2019-10-01 09:00:00'
updated_at: '2019-10-01 09:00:00'
- id: 0ad7a75a-1517-4b86-bb8a-9443d4965e60
user_id: ca0a4e09-c266-4f6f-845c-958db5090f09
value: example.com
type: domain
blocked: 0
last_blocked: null
created_at: '2019-10-01 09:00:00'
updated_at: '2019-10-01 09:00:00'
items:
type: object
properties:
id:
type: string
example: 8bff51ba-1917-466f-8f54-641a9e711eb8
user_id:
type: string
example: ca0a4e09-c266-4f6f-845c-958db5090f09
value:
type: string
example: spam@example.com
type:
type: string
example: email
blocked:
type: integer
example: 4
last_blocked:
type: string
example: '2019-10-01 09:00:00'
created_at:
type: string
example: '2019-10-01 09:00:00'
updated_at:
type: string
example: '2019-10-01 09:00:00'
tags:
- Blocklist
post:
summary: Create New Blocklist Entry
operationId: createNewBlocklistEntry
description: This endpoint creates a new blocklist entry.
parameters:
- in: header
name: X-Requested-With
description: ''
example: XMLHttpRequest
schema:
type: string
responses:
201:
description: ''
content:
application/json:
schema:
type: object
example:
data:
id: 8bff51ba-1917-466f-8f54-641a9e711eb8
user_id: ca0a4e09-c266-4f6f-845c-958db5090f09
value: spam@example.com
type: email
blocked: 0
last_blocked: null
created_at: '2019-10-01 09:00:00'
updated_at: '2019-10-01 09:00:00'
properties:
data:
type: object
properties:
id:
type: string
example: 8bff51ba-1917-466f-8f54-641a9e711eb8
user_id:
type: string
example: ca0a4e09-c266-4f6f-845c-958db5090f09
value:
type: string
example: spam@example.com
type:
type: string
example: email
blocked:
type: integer
example: 0
last_blocked:
type:
- string
- 'null'
example: null
created_at:
type: string
example: '2019-10-01 09:00:00'
updated_at:
type: string
example: '2019-10-01 09:00:00'
tags:
- Blocklist
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
type:
type: string
description: The type of the blocklist entry, options - email, domain.
example: email
value:
type: string
description: The value of the blocklist entry, this is the email address or domain name.
example: example.com
required:
- type
- value
/api/v1/blocklist/store/bulk:
post:
summary: Bulk create blocklist entries
operationId: bulkCreateBlocklistEntries
description: ''
parameters:
- in: header
name: X-Requested-With
description: ''
example: XMLHttpRequest
schema:
type: string
responses:
201:
description: ''
content:
text/plain:
schema:
type: string
example: '{"data": [...], "message": "3 entries added to blocklist", "skipped": 0}'
tags:
- Blocklist
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
type:
type: string
description: The type of entries, options - email, domain.
example: email
values:
type: array
description: An array of values (max 50).
example:
- spam@example.com
- other@example.com
items:
type: string
required:
- type
- values
/api/v1/blocklist/delete/bulk:
post:
summary: Bulk delete blocklist entries
operationId: bulkDeleteBlocklistEntries
description: ''
parameters:
- in: header
name: X-Requested-With
description: ''
example: XMLHttpRequest
schema:
type: string
responses:
200:
description: ''
content:
application/json:
schema:
type: object
example:
message: 3 entries removed from blocklist
ids:
- '...'
properties:
message:
type: string
example: 3 entries removed from blocklist
ids:
type: array
example:
- '...'
items:
type: string
tags:
- Blocklist
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
ids:
type: array
description: An array of blocklist entry ids (max 100).
example:
- 8bff51ba-1917-466f-8f54-641a9e711eb8
items:
type: string
required:
- ids
/api/v1/blocklist/{id}:
parameters:
- in: path
name: id
description: The id of the blocklist entry to delete
example: 8bff51ba-1917-466f-8f54-641a9e711eb8
required: true
schema:
type: string
delete:
summary: Delete a Specific Blocklist Entry
operationId: deleteASpecificBlocklistEntry
description: This endpoint deletes a specific blocklist entry.
parameters:
- in: header
name: X-Requested-With
description: ''
example: XMLHttpRequest
schema:
type: string
responses:
204:
description: ''
content:
application/json:
schema:
type: object
example: {}
properties: {}
tags:
- Blocklist
components:
securitySchemes:
default:
type: http
scheme: bearer
description: You can retrieve your API key by visiting your <a href="https://app.addy.io/settings/api">account settings</a> and clicking <b>Create New API Key</b>.