Mailchimp Ping API

The ping API from Mailchimp — 1 operation(s) for ping.

Operations 2

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /ping Check that the Marketing API is up · Ping #
Ask an LLM
“Is the Mailchimp Marketing API reachable right now?”
“Can I test my API key and connection without touching account data?”
Tell an agent
Ping the Marketing API to confirm it's healthy.
Run a health check against the API.
GET /3.0/ping Ping #

Specifications

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/mailchimp:mailchimp-ping-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

mailchimp-ping-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Mailchimp Ping API
  contact:
    name: Mailchimp API Support
    email: apihelp@mailchimp.com
  x-refined-note:
  - x-permalink differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged ping across 2 of this provider''s published API definitions: mailchimp-marketing-api-openapi-original.json, mailchimp-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://server.api.mailchimp.com/3.0
- description: Mailchimp API
  url: https://api.mailchimp.com
tags:
- name: Ping
paths:
  /ping:
    get:
      summary: Ping
      description: A health check for the API that won't return any account-specific information.
      operationId: getPing
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                title: API health status
                description: API health status.
                properties:
                  health_status:
                    type: string
                    title: API health status
                    description: This will return a constant string value if the request is successful. Ex. "Everything's Chimpy!"
                    readOnly: true
                    example: '"Everything''s Chimpy!"'
            application/problem+json:
              schema:
                type: object
                title: API health status
                description: API health status.
                properties:
                  health_status:
                    type: string
                    title: API health status
                    description: This will return a constant string value if the request is successful. Ex. "Everything's Chimpy!"
                    readOnly: true
                    example: '"Everything''s Chimpy!"'
        default:
          description: An error generated by the Mailchimp API.
          content:
            application/json:
              schema:
                type: object
                title: Problem Detail Document
                description: An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'.
                required:
                - type
                - title
                - status
                - detail
                - instance
                properties:
                  type:
                    type: string
                    title: Problem Type
                    description: An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type.
                    example: https://mailchimp.com/developer/marketing/docs/errors/
                  title:
                    type: string
                    title: Error Title
                    description: A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization.
                    example: Resource Not Found
                  status:
                    type: integer
                    title: HTTP Status Code
                    description: The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem.
                    example: 404
                  detail:
                    type: string
                    title: Error Message
                    description: A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](/developer/guides/get-started-with-mailchimp-api-3/#Errors).
                    example: The requested resource could not be found.
                  instance:
                    type: string
                    title: Instance ID
                    description: A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support.
                    example: 995c5cb0-3280-4a6e-808b-3b096d0bb219
            application/problem+json:
              schema:
                type: object
                title: Problem Detail Document
                description: An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'.
                required:
                - type
                - title
                - status
                - detail
                - instance
                properties:
                  type:
                    type: string
                    title: Problem Type
                    description: An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type.
                    example: https://mailchimp.com/developer/marketing/docs/errors/
                  title:
                    type: string
                    title: Error Title
                    description: A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization.
                    example: Resource Not Found
                  status:
                    type: integer
                    title: HTTP Status Code
                    description: The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem.
                    example: 404
                  detail:
                    type: string
                    title: Error Message
                    description: A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](/developer/guides/get-started-with-mailchimp-api-3/#Errors).
                    example: The requested resource could not be found.
                  instance:
                    type: string
                    title: Instance ID
                    description: A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support.
                    example: 995c5cb0-3280-4a6e-808b-3b096d0bb219
      deprecated: false
      tags:
      - Ping
      x-custom-config:
        methodNameSnake: get
        methodNameCamel: get
      security:
      - basicAuth: []
    servers:
    - url: https://server.api.mailchimp.com/3.0
  /3.0/ping:
    get:
      description: A health check for the API that won't return any account-specific information.
      operationId: get30Ping
      responses:
        '200':
          content:
            application/json:
              schema:
                description: API health status.
                properties:
                  health_status:
                    description: This will return a constant string value if the request is successful. Ex. "Everything's Chimpy!"
                    example: '"Everything''s Chimpy!"'
                    readOnly: true
                    title: API health status
                    type: string
                title: API health status
                type: object
          description: ''
        default:
          content:
            application/problem+json:
              schema:
                description: 'An error generated by the Mailchimp API. The response conforms to [RFC 9457: Problem Details for HTTP APIs](https://www.rfc-editor.org/rfc/rfc9457).'
                properties:
                  detail:
                    description: A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](/developer/guides/get-started-with-mailchimp-api-3/#Errors).
                    examples:
                    - The requested resource could not be found.
                    title: Error Message
                    type: string
                  instance:
                    description: A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support.
                    examples:
                    - 995c5cb0-3280-4a6e-808b-3b096d0bb219
                    title: Instance ID
                    type: string
                  status:
                    description: The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem.
                    examples:
                    - 404
                    title: HTTP Status Code
                    type: integer
                  title:
                    description: A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization.
                    examples:
                    - Resource Not Found
                    title: Error Title
                    type: string
                  type:
                    description: An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type.
                    examples:
                    - https://mailchimp.com/developer/marketing/docs/errors/
                    title: Problem Type
                    type: string
                required:
                - detail
                - instance
                - status
                - title
                - type
                title: Problem Detail Document
                type: object
          description: An error generated by the Mailchimp API.
      summary: Ping
      tags:
      - Ping
      x-custom-config:
        methodNameCamel: get
        methodNameSnake: get
      security:
      - bearerToken: []
      - oauth2: []
      x-operation-id-source: normalized
      x-operation-id-original: getPing
    servers:
    - description: Mailchimp API
      url: https://api.mailchimp.com
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
    bearerToken:
      description: Authorization using a Mailchimp API key (a.k.a. Bearer token)
      scheme: Bearer
      type: http
    oauth2:
      description: Authorization using OAuth
      flows:
        authorizationCode:
          authorizationUrl: https://login.mailchimp.com/oauth2/authorize
          scopes: {}
          tokenUrl: https://login.mailchimp.com/oauth2/token
      type: oauth2
externalDocs:
  description: Learn more with the full Mailchimp API documentation.
  url: https://mailchimp.com/developer/marketing/
x-refined-from:
- mailchimp-marketing-api-openapi-original.json


# --- truncated at 32 KB (39 KB total) ---
# Full source: https://artifacts.apis.io/mailchimp/openapi/mailchimp-ping-api-openapi.yml