Telesign

Telesign Deactivated Numbers API

Encoding: Accepts only UTF-8 encoded unicode characters as inputs. The Deactivated Numbers API can be used to get lists of deactivated numbers. These can be used to ensure you don't send SMS messages to these numbers using our SMS and SMS Verify products.

GitHub OpenAPI

Operations 2

GET /files Get file list #
GET /download/{file_name} Get file #

Documentation

📖
Documentation
https://developer.telesign.com/enterprise/reference/getdeactnumfilelist

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/telesign/refs/heads/main/openapi/telesign-deactivated-numbers-api-openapi.yml
⚙
OpenAPI
https://developer.telesign.com/enterprise/openapi/deactivated-numbers-api.json

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/telesign/refs/heads/main/json-schema/telesign-deact-res-file-list-schema.json

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/telesign:deactivated-numbers-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

telesign-deactivated-numbers-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Deactivated Numbers API
  version: '1.0'
  description: '**Encoding:** Accepts only UTF-8 encoded unicode characters as inputs.


    The Deactivated Numbers API can be used to get lists of deactivated numbers. These can be used to ensure you don''t send SMS messages to these numbers using our SMS and SMS Verify products.'
  contact:
    name: Telesign Customer Support Team
    email: support@telesign.com
servers:
- url: https://deact-api.telesign.com
security:
- Basic: []
- Digest: []
- UserSecurity: []
tags:
- name: Deactivated Numbers
paths:
  /files:
    get:
      responses:
        '200':
          description: '**Success.** Your request was fulfilled and a list of file names was retrieved.


            Code | Meaning

            --|--

            2200|Request successfully completed'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeactResFileList'
              examples:
                response:
                  value:
                    list_of_files:
                    - att-deacts_20210719.zip
                    - verizon-deacts_20210719.zip
                    code: 2200
                    description: Request successfully completed
        '401':
          description: '**Unauthorized.** The request requires user authentication. Customer ID and/or API Key were not provided or were not valid.


            Code | Meaning

            --|--

            2201|Unauthorized access.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorObject'
              examples:
                response:
                  value:
                    code: 2201
                    description: Unauthorized access
        '403':
          description: '**Forbidden.** This user does not have access to this resource.


            Code | Meaning

            --|--

            2203|Request forbidden'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorObject'
              examples:
                response:
                  value:
                    code: 2203
                    description: Request forbidden
        '500':
          description: '**Internal server error.** There was a problem on our side. Try again later.


            Code | Meaning

            --|--

            2250|Internal Server Error'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorObject'
              examples:
                response:
                  value:
                    code: 2250
                    description: Internal Server Error
      summary: Get file list
      description: 'Use this action to get a list of files accessible for you to download that contain deactivated phone numbers.


        ## General requirements

        * **Authentication:** Basic (easiest to implement) or Digest

        * **Encoding:** Accepts only **UTF-8 unicode** characters as inputs.

        * **Responds with:** `application/json`

        * **Rate limit:** Default rate limits by product'
      tags:
      - Deactivated Numbers
      operationId: getDeactNumFileList
  /download/{file_name}:
    parameters:
    - name: file_name
      in: path
      required: true
      schema:
        type: string
    get:
      responses:
        '200':
          description: '**Success.** Your request was fulfilled and a file was retrieved. Note that no response JSON object is returned in the payload, only the contents of the file itself.'
          content:
            application/octet-stream:
              schema: {}
        '401':
          description: '**Unauthorized.** The request requires user authentication. Customer ID and/or API Key were not provided or were not valid.


            Code | Meaning

            --|--

            2201|Unauthorized access.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorObject'
              examples:
                response:
                  value:
                    code: 2201
                    description: Unauthorized access
        '403':
          description: '**Forbidden.** This user does not have access to this resource.


            Code | Meaning

            --|--

            2203|Request forbidden'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorObject'
              examples:
                response:
                  value:
                    code: 2203
                    description: Request forbidden
        '404':
          description: '**File not found.** The file was not available to retrieve.


            Code | Meaning

            --|--

            2204|Download failed, the file you are trying to download doesn''t exist or may have been deleted.

            '
          content:
            application/octet-stream:
              schema:
                $ref: '#/components/schemas/errorObject'
              examples: {}
            application/json:
              examples:
                response:
                  value:
                    code: 2204
                    description: Download failed, the file you are trying to download doesn't exist or may have been deleted.
        '500':
          description: '**Internal server error.** There was a problem on our side. Try again later.


            Code | Meaning

            --|--

            2250|Internal Server Error'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorObject'
              examples:
                response:
                  value:
                    code: 2250
                    description: Internal Server Error
      parameters:
      - in: path
        name: file_name
        required: true
        description: The filename of the deactivated numbers file you want to download.
        schema:
          type: string
      description: 'Use this action to download one specified file that contains deactivated phone numbers.


        ## General requirements

        * **Authentication:** Basic (easiest to implement) or Digest

        * **Encoding:** Accepts only **UTF-8 unicode** characters as inputs.

        * **Responds with:** `application/json` or `application/octet-stream`

        * **Rate limit:** Default rate limits by product'
      summary: Get file
      tags:
      - Deactivated Numbers
      operationId: getDeactNumFile
components:
  schemas:
    errorObject:
      type: object
      title: errorObject
      description: Contains properties related to an error that occurred during processing of the request.
      properties:
        code:
          type: integer
          description: A numeric code specifying which error occurred.
          example: -10001
        description:
          type: string
          description: Text describing the error that occurred.
          example: 'Invalid Request: PhoneNumber Parameter'
    DeactResFileList:
      type: object
      title: DeactResFileList
      description: ''
      properties:
        list_of_files:
          type: array
          description: Each element in this array is the name of a compressed file containing deactivated numbers. Use these filenames with the `/download/{file_name}` endpoint to download the available files as needed.
          example:
          - att-deacts_20210719.zip
          items:
            type: string
        code:
          type: integer
          description: A numeric code indicating the status of processing this request.
          example: 2200
        description:
          type: string
          description: A text description of processing status of this request.
          example: Request successfully completed
  securitySchemes:
    UserSecurity:
      type: http
      scheme: basic
    Basic:
      type: http
      description: Easiest to implement. See [Basic Authentication](/api-reference/authentication#basic-authentication) for more details.
      scheme: basic
    Digest:
      type: apiKey
      name: Authorization
      in: header
      description: See [Digest Authentication](/api-reference/authentication#digest-authentication) for more details.
x-stoplight:
  docs:
    showModels: false
  id: 3a28b99e5b681
x-readme:
  explorer-enabled: true
  proxy-enabled: true
  samples-enabled: true