Splio

Splio Blacklist API

The Blacklist API from Splio — 4 operation(s) for blacklist.

GitHub OpenAPI

Operations 4

GET /data/blacklists/cellphones Get blacklisted cellphones #
POST /data/blacklists/{channel} Add touchpoint(s) in a custom blacklist #
DELETE /data/blacklists/{channel}/{source} Delete touchpoint(s) from blacklist #
GET /data/blacklists/emails Get blacklisted emails #

Documentation

📖
Documentation
https://dev-scp.splio.com/docs
📖
APIReference
https://dev-scp.splio.com/reference
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/splio/refs/heads/main/authentication/splio-authentication.yml
📖
Documentation
https://dev-scp.splio.com/reference/post_messages
📖
Documentation
https://dev-scp.splio.com/docs/migrate-from-launch-api-to-content-campaign-apis-splio-edition-2025
📖
Documentation
https://dev-scp.splio.com/reference/post_v1-create-email-design
📖
Documentation
https://dev-scp.splio.com/docs/datahub-events

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/splio/refs/heads/main/openapi/splio-blacklist-api-openapi.yml

Other Resources

🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/splio/refs/heads/main/errors/splio-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/splio/refs/heads/main/data-model/splio-data-model.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/splio/refs/heads/main/conventions/splio-conventions.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/splio-blacklist-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

splio-blacklist-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Splio Customer Platform Blacklist API
  description: API Documentation for Splio Customer Platform
  version: 1.0.0
servers:
- url: https://api.splio.com
- url: http://api.splio.com
tags:
- name: Blacklist
paths:
  /data/blacklists/cellphones:
    get:
      summary: Get blacklisted cellphones
      description: Get blacklisted cellphones.
      parameters:
      - name: source
        in: query
        required: false
        description: Source of blacklisted cellphones. By default blacklisted cellphones of all source are returned.
        schema:
          type: string
          enum:
          - custom
          - stop
          - soft
          - bounce
      - name: per_page
        in: query
        required: false
        description: Number of items displayed per page.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
          default: 50
      - name: page_number
        in: query
        required: false
        description: Page number.
        schema:
          type: integer
          minimum: 1
          default: 1
      - name: term
        in: query
        required: false
        description: Filter results on a specific value.
        schema:
          type: string
      responses:
        '200':
          description: Blacklists retrieval is successful.
          content:
            application/json:
              examples:
                response:
                  value:
                    count_element: 1
                    current_page: 1
                    per_page: 50
                    sort: []
                    elements:
                    - number: '33614021388'
                      creation_date: '2017-05-09'
                      source: custom
        '400':
          description: The request validation failed.
          x-readme: BODYBODY
          content:
            application/json:
              examples:
                response:
                  value:
                    status: 400
                    errors:
                    - error_key: field_1
                      error: wrong_value
                      error_description: The request was malformed and it is unable to be processed. Please review and try again.
        '401':
          description: Authentication failed.
        '403':
          description: Forbidden.
      tags:
      - Blacklist
      security:
      - Bearer: []
      operationId: getDataBlacklistsCellphones
      x-operation-id-source: derived
  /data/blacklists/{channel}:
    post:
      summary: Add touchpoint(s) in a custom blacklist
      description: Add touchpoint(s) in a custom blacklist.
      parameters:
      - name: channel
        in: path
        required: true
        description: 'Touchpoint channel : *email* or *cellphone*.'
        schema:
          type: string
          enum:
          - cellphone
          - email
      requestBody:
        content:
          application/json:
            schema:
              required:
              - data
              properties:
                data:
                  items:
                    type: string
                  type: array
              type: object
        description: Touchpoints to add to blacklist.
        required: true
      responses:
        '200':
          description: Blacklisting touchpoint(s) is successful.
          content:
            application/json:
              examples:
                response:
                  value:
                    successes:
                    - 1234@test.com
                    - 456@test.com
                    failures: []
        '207':
          description: Blacklisting touchpoint(s) is partially successful.
          content:
            application/json:
              examples:
                response:
                  value:
                    successes:
                    - 1234@test.com
                    - 456@test.com
                    failures:
                    - touchpoint: john@doe.com
                      error: Touchpoint john@doe.com is already blacklisted.
                      error_key: touchpoint_already_exist
        '400':
          description: Blacklisting touchpoint(s) failed.
          content:
            application/json:
              examples:
                response:
                  value:
                    successes: []
                    failures:
                    - touchpoint: john@doe.com
                      error: Touchpoint john@doe.com is already blacklisted.
                      error_key: touchpoint_already_exist
        '401':
          description: Authentication failed.
        '403':
          description: Forbidden.
      tags:
      - Blacklist
      security:
      - Bearer: []
      operationId: postDataBlacklistsByChannel
      x-operation-id-source: derived
  /data/blacklists/{channel}/{source}:
    delete:
      summary: Delete touchpoint(s) from blacklist
      description: Delete touchpoint(s) from blacklist.
      parameters:
      - name: channel
        in: path
        required: true
        description: 'Touchpoint channel : *email* or *cellphone*.'
        schema:
          type: string
          enum:
          - cellphone
          - email
      - name: source
        in: path
        required: true
        description: 'Touchpoint source : *custom* or *unsub* (only available for email channel) or *all* (custom + unsub).'
        schema:
          type: string
          enum:
          - custom
          - unsub
          - all
      requestBody:
        content:
          application/json:
            schema:
              required:
              - data
              properties:
                data:
                  items:
                    type: string
                  type: array
              type: object
        description: data.
        required: true
      responses:
        '200':
          description: Deleting touchpoint(s) from blacklist is successful.
          content:
            application/json:
              examples:
                response:
                  value:
                    successes:
                    - 1234@test.com
                    - 456@test.com
                    failures: []
        '207':
          description: Deleting touchpoint(s) from blacklist is partially successful.
          content:
            application/json:
              examples:
                response:
                  value:
                    successes:
                    - 1234@test.com
                    - 456@test.com
                    failures:
                    - touchpoint: john@doe.com
                      error: Touchpoint john@doe.com not found in custom blacklist.
                      error_key: touchpoint_not_blacklisted
        '400':
          description: Blacklisting touchpoint(s) failed.
          content:
            application/json:
              examples:
                response:
                  value:
                    successes: []
                    failures:
                    - touchpoint: john@doe.com
                      error: Touchpoint john@doe.com not found in custom blacklist.
                      error_key: touchpoint_not_blacklisted
        '401':
          description: Authentication failed.
        '403':
          description: Forbidden.
      tags:
      - Blacklist
      security:
      - Bearer: []
      operationId: deleteDataBlacklistsByChannelBySource
      x-operation-id-source: derived
  /data/blacklists/emails:
    get:
      summary: Get blacklisted emails
      description: Get blacklisted emails.
      parameters:
      - name: source
        in: query
        required: false
        description: Source of blacklisted emails. By default blacklisted emails of all source are returned.
        schema:
          type: string
          enum:
          - custom
          - unsub
          - soft
          - fbl
          - bounce
      - name: per_page
        in: query
        required: false
        description: Number of items displayed per page.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
          default: 50
      - name: page_number
        in: query
        required: false
        description: Page number.
        schema:
          type: integer
          minimum: 1
          default: 1
      - name: term
        in: query
        required: false
        description: Filter results on a specific value.
        schema:
          type: string
      responses:
        '200':
          description: Blacklists retrieval is successful.
          content:
            application/json:
              examples:
                response:
                  value:
                    count_element: 1
                    current_page: 1
                    per_page: 50
                    sort: []
                    elements:
                    - number: john@doe.com
                      creation_date: '2017-05-09'
                      source: custom
        '400':
          description: The request validation failed.
          x-readme: BODYBODY
          content:
            application/json:
              examples:
                response:
                  value:
                    status: 400
                    errors:
                    - error_key: field_1
                      error: wrong_value
                      error_description: The request was malformed and it is unable to be processed. Please review and try again.
        '401':
          description: Authentication failed.
        '403':
          description: Forbidden.
      tags:
      - Blacklist
      security:
      - Bearer: []
      operationId: getDataBlacklistsEmails
      x-operation-id-source: derived
components:
  securitySchemes:
    Bearer:
      description: "For accessing the API a valid JWT token must be passed in all requests in\nthe 'Authorization' header.\n\n\nA valid JWT token is generated by the Authorization API and returned as answer of a call\nto the route /authenticate giving a valid user, password & universe.\n\n\nThe following syntax must be used in the 'Authorization' header :\n\n    Bearer xxxxxx.yyyyyyy.zzzzzz\n"
      type: http
      scheme: bearer
      bearerFormat: JWT
x-origin:
- url: https://api.splio.com/doc.json
  format: swagger
  version: '2.0'
  converter:
    url: https://github.com/mermade/oas-kit
    version: 7.0.8