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/apptoto:apptoto-lists-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

openapi: 3.2.0
info:
  title: api-settings Lists API
  version: '1.0'
servers:
- url: https://api.apptoto.com
security:
- sec0: []
- sec1: []
tags:
- name: Lists
paths:
  /v1/lists:
    get:
      summary: /v1/lists
      description: The endpoint allows you to fetch the list of phone numbers or email addresses that have been previously opted-out or opted-in to receiving messages from Apptoto.
      operationId: v1lists
      parameters:
      - name: type
        in: query
        description: Should be "out" or "in".  The type of list to fetch.  "out" will fetch all of the phone numbers or email addresses that been opted out.  "in" will fetch all of the phone numbers or email addresses that have opted-in.
        required: true
        schema:
          type: string
      - name: comm_type
        in: query
        description: Should be "call", "sms", or "email".
        required: true
        schema:
          type: string
      deprecated: false
      security:
      - sec0: []
      - sec1:
        - lists:read
      tags:
      - Lists
    post:
      summary: /v1/lists
      description: This endpoint allows you to add an entry to an opt-out or opt-in list.
      operationId: v1lists-1
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - type
              - comm_type
              - entry
              properties:
                type:
                  type: string
                  description: '"out" or "in".  The type of list to add to.'
                comm_type:
                  type: string
                  description: '"call", "sms", or "email".'
                entry:
                  type: string
                  description: The phone number or email address to add.  Phone numbers will be normalized using the user's country setting, unless a country code is provided (e.g. +16505551212)
      deprecated: false
      security:
      - sec0: []
      - sec1:
        - lists:write
      tags:
      - Lists
    put:
      summary: /v1/lists
      description: This endpoint allows you to update an entire opt-out or opt-in list of phone numbers or email addresses for each type of message (call, sms, or email).
      operationId: v1lists-3
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - type
              - comm_type
              - list
              properties:
                type:
                  type: string
                  description: '"out" or "in".  The type of list to add to.'
                comm_type:
                  type: string
                  description: '"call", "sms", or "email".'
                list:
                  type: array
                  description: The list of phone numbers and email addresses for the list.  Any number or email address not included will be removed the user's list.  Phone numbers will be normalized using the user's country setting, unless a country code is provided (e.g. +16505551212).
                  items:
                    type: string
      deprecated: false
      security:
      - sec0: []
      - sec1:
        - lists:write
      tags:
      - Lists
    delete:
      summary: /v1/lists
      description: This endpoint allows you to remove an entry from an opt-out or opt-in list.
      operationId: v1lists-2
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - type
              - comm_type
              - entry
              properties:
                type:
                  type: string
                  description: '"out" or "in".  The type of list to add to.'
                comm_type:
                  type: string
                  description: '"call", "sms", or "email".'
                entry:
                  type: string
                  description: The phone number or email address to remove.  Phone numbers will be normalized using the user's country setting, unless a country code is provided (e.g. +16505551212)
      deprecated: false
      security:
      - sec0: []
      - sec1:
        - lists:write
      tags:
      - Lists
components:
  securitySchemes:
    sec0:
      type: http
      scheme: basic
    sec1:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://www.apptoto.com/oauth/authorize
          tokenUrl: https://api.apptoto.com/oauth/token
          refreshUrl: https://api.apptoto.com/oauth/token
          scopes:
            calendars:read: View calendars
            address_books:read: View address books
            contacts:read: View contacts
            contacts:write: Create, update, and delete contacts
            events:read: View calendar events
            events:write: Create, update, and delete events; mark event statuses
            bookings:read: View booking page availability and existing bookings
            bookings:write: Create bookings on booking pages
            imports:read: Check the status of imports
            imports:write: Upload imports (CSV / ICS / XML) that bulk-create data
            lists:read: View opt-in and opt-out lists
            lists:write: Modify opt-in and opt-out lists
            messaging:read: View conversations and message history
            messaging:send: Send SMS or email messages on the user's behalf
            webhooks:read: View webhooks
            webhooks:write: Create, update, and delete webhooks that send account activity to other services
x-readme-fauxas: true
x-provenance:
  method: searched
  source: https://apidocs.apptoto.com/reference
  harvested: '2026-10-28'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://apidocs.apptoto.com/reference/import-upload.md
  - https://apidocs.apptoto.com/reference/v1address_books.md
  - https://apidocs.apptoto.com/reference/v1availability.md
  - https://apidocs.apptoto.com/reference/v1book_now-1.md
  - https://apidocs.apptoto.com/reference/v1booking_pages.md
  - https://apidocs.apptoto.com/reference/v1bookings.md
  - https://apidocs.apptoto.com/reference/v1calendars-1.md
  - https://apidocs.apptoto.com/reference/v1contact.md
  - https://apidocs.apptoto.com/reference/v1contacts-1.md
  - https://apidocs.apptoto.com/reference/v1contacts-2.md
  - https://apidocs.apptoto.com/reference/v1contacts-3.md
  - https://apidocs.apptoto.com/reference/v1contacts.md
  - https://apidocs.apptoto.com/reference/v1contactstag.md
  - https://apidocs.apptoto.com/reference/v1conversation_messages.md
  - https://apidocs.apptoto.com/reference/v1conversation_reply.md
  - https://apidocs.apptoto.com/reference/v1conversation_templates.md
  - https://apidocs.apptoto.com/reference/v1conversations.md
  - https://apidocs.apptoto.com/reference/v1event.md
  - https://apidocs.apptoto.com/reference/v1eventmark.md
  - https://apidocs.apptoto.com/reference/v1events-1.md
  - https://apidocs.apptoto.com/reference/v1events-2.md
  - https://apidocs.apptoto.com/reference/v1events-3.md
  - https://apidocs.apptoto.com/reference/v1events.md
  - https://apidocs.apptoto.com/reference/v1eventtag.md
  - https://apidocs.apptoto.com/reference/v1import.md
  - https://apidocs.apptoto.com/reference/v1lists-1.md
  - https://apidocs.apptoto.com/reference/v1lists-2.md
  - https://apidocs.apptoto.com/reference/v1lists-3.md
  - https://apidocs.apptoto.com/reference/v1lists.md
  - https://apidocs.apptoto.com/reference/v1participantmark.md
  - https://apidocs.apptoto.com/reference/v1participants-1.md
  - https://apidocs.apptoto.com/reference/v1participants-2.md
  - https://apidocs.apptoto.com/reference/v1participants-3.md
  - https://apidocs.apptoto.com/reference/v1participants.md
  - https://apidocs.apptoto.com/reference/v1participants_auto_messages-1.md
  - https://apidocs.apptoto.com/reference/v1participants_auto_messages.md
  - https://apidocs.apptoto.com/reference/v1participanttag.md
  - https://apidocs.apptoto.com/reference/v1start_conversation.md
  - https://apidocs.apptoto.com/reference/v1userinfo.md
  - https://apidocs.apptoto.com/reference/v1webhooks-1.md
  - https://apidocs.apptoto.com/reference/v1webhooks-2.md
  - https://apidocs.apptoto.com/reference/v1webhooks-3.md
  - https://apidocs.apptoto.com/reference/v1webhooks.md
  merge:
    pages: 43
    deduped: 84
    conflicts_kept_first: 0