ParseAPI MX API

Mail exchange records for a domain.

GitHub OpenAPI

Operations 1

GET /mx/{domain} MX records for a domain #

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/parseapi-com:parseapi-com-mx-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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

parseapi-com-mx-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Parse MX API
  version: 1.0.0
  summary: Fast APIs for developers, locate, validate, decode.
  description: 'One base URL, one key, minimal JSON. Response schemas describe API 2.3.0. Paid plans include their profile detail automatically at its natural resource homes; Free returns the complete ordinary answer. There is no deep response object. When neither version header is sent, requests use the saved team default, or 1.0.0 for keyless self-lookups. Read https://parseapi.com/docs/versioning for other supported contracts. Responses that reach the organization rate check carry X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset. Optional X-RateLimit-Burst indicates continuous refill. Rate-limit 429 responses add Retry-After (seconds). See https://parseapi.com/agents and https://parseapi.com/llms.txt for agent-oriented guidance. Field-level docs: https://parseapi.com/docs Free-plan users must include a link to ParseAPI on their website, app, or project documentation. A footer, about page, credits page, or another reasonable location is fine. Paid plans do not require ParseAPI attribution. Example HTML: Data provided by ParseAPI. Details: https://parseapi.com/legal/attribution#crediting-parseapi.'
  termsOfService: https://parseapi.com/legal/terms
  contact:
    name: ParseAPI
    email: hello@parseapi.com
    url: https://parseapi.com
servers:
- url: https://api.parseapi.com
  description: Production
tags:
- name: MX
  description: Mail exchange records for a domain.
  externalDocs:
    description: MX API docs
    url: https://parseapi.com/docs/mx
paths:
  /mx/{domain}:
    get:
      operationId: mx
      tags:
      - MX
      summary: MX records for a domain
      description: 'Ordered MX records with priority and host. A priority-0 host of . is an explicit null MX: the domain accepts no mail. An empty array means no MX records, which permits SMTP A/AAAA fallback. Full field reference: https://parseapi.com/docs/mx'
      security:
      - ApiKeyAuth: []
      - BearerAuth: []
      parameters:
      - $ref: '#/components/parameters/ParseVersion'
      - name: domain
        in: path
        required: true
        description: Domain name
        schema:
          type: string
          example: example.com
      responses:
        '200':
          description: Success, minimal JSON object (shape varies by endpoint)
          headers:
            X-RateLimit-Limit:
              description: Sustained requests per minute for your team
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Estimated requests available in the current window or token bucket
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
              schema:
                type: integer
            X-RateLimit-Burst:
              description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
              schema:
                type: integer
            X-API-Version:
              description: The exact response contract selected for this request.
              schema:
                type: string
                enum:
                - 1.0.0
                - 2.0.0
                - 2.1.0
                - 2.2.0
                - 2.3.0
          content:
            application/json:
              schema:
                type: object
                properties:
                  domain:
                    type: string
                  mx:
                    type: array
                    items:
                      type: object
                      properties:
                        priority:
                          type: number
                        host:
                          type: string
                      required:
                      - priority
                      - host
                      additionalProperties: true
                required:
                - domain
                - mx
                additionalProperties: true
        '400':
          description: invalid_request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: invalid_api_key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: permission_denied or plan_required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: not_found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '410':
          description: api_version_retired
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: rate_limited or quota_exceeded
          headers:
            X-RateLimit-Limit:
              description: Sustained requests per minute for your team
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Estimated requests available in the current window or token bucket
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
              schema:
                type: integer
            X-RateLimit-Burst:
              description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
              schema:
                type: integer
            Retry-After:
              description: Seconds to wait before retrying
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: server_error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: service_unavailable
          headers:
            Retry-After:
              description: Seconds to wait before retrying
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  parameters:
    ParseVersion:
      name: X-API-Version
      in: header
      required: false
      description: Exact response contract for this lookup. Overrides the saved team default for this request only. Legacy Parse-Version is also accepted; both headers must match if sent together. With neither header, keyed requests use that default and keyless self-lookups use 1.0.0. Invalid or unsupported values return invalid_request (400). Retired selections return api_version_retired (410). Reference/help URLs keep their documented version and do not use this selector.
      schema:
        type: string
        enum:
        - 1.0.0
        - 2.0.0
        - 2.1.0
        - 2.2.0
        - 2.3.0
        example: 2.3.0
  schemas:
    Error:
      type: object
      required:
      - code
      - message
      - docs
      - request_id
      properties:
        code:
          type: string
          description: Machine-readable error code
          enum:
          - invalid_request
          - ambiguous_time
          - nonexistent_time
          - invalid_api_key
          - permission_denied
          - plan_required
          - not_found
          - api_version_retired
          - rate_limited
          - quota_exceeded
          - server_error
          - service_unavailable
          - dns_resolution_failed
          - task_invalid
          - task_not_found
          - task_request_conflict
          - task_budget_exceeded
          - task_limit_exceeded
          - task_terms_changed
          - task_expired
          - task_cancelled
          - task_in_progress
          - task_outcome_unknown
          - task_unavailable
        message:
          type: string
        docs:
          type: string
          format: uri
          description: Link to the docs section for this error
        request_id:
          type: string
          description: Send this if you contact support
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key from the ParseAPI dashboard
    BearerAuth:
      type: http
      scheme: bearer
      description: 'Same key as X-API-Key, via Authorization: Bearer'