MepMail Account API

Plan, usage and deliverability of the team.

GitHub OpenAPI

Operations 2

GET /usage Get plan and usage #
GET /deliverability Get the deliverability score #

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/mepmail-dev:mepmail-dev-account-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

mepmail-dev-account-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Mepmail Dev Account API
  version: 1.0.0
  description: 'Operations tagged Account across 2 of this provider''s published API definitions: docs.json, mepmail-dev-docs-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.mepmail.dev
  description: MepMail Cloud
- url: '{baseUrl}'
  description: Self-hosted instance
  variables:
    baseUrl:
      default: http://localhost:3001
security:
- apiKey: []
tags:
- name: Account
  description: Plan, usage and deliverability of the team.
paths:
  /usage:
    get:
      responses:
        '200':
          description: Effective plan and usage limits. Annual Send contracts renew their 110K allowance monthly within the paid year; overage is disabled and its numeric rate is zero. MepMail extension; plan, limits and period are null on self-hosted and system teams.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsageResponse'
              example:
                object: usage
                cloud: false
                plan: free
                limits:
                  emails_per_day: 1
                  emails_per_month: 1
                  domains: 1
                  contacts: 1
                today:
                  emails_sent: 1
                  resets_at: '2026-10-19T12:00:00.000Z'
                period:
                  emails_sent: 1
                  included: 1
                  overage_enabled: false
                  overage_usd_per_1k: 1
                  starts_at: '2026-10-19T12:00:00.000Z'
                  ends_at: '2026-10-19T12:00:00.000Z'
                team:
                  id: faccb7a5-8a28-4e9a-ac64-8da1cc3bc1cb
                  name: Order updates
                app_url: app url
        '401':
          description: Missing, malformed or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Restricted API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Contract terms or bindings unavailable. Counters remain under usage; period is null when no monthly allowance is verified. No estimated or null overage rate is returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsageTermsUnavailable'
        '429':
          description: 'Rate limit exceeded: 600 requests per minute per API key and 3,000 per team; wait for Retry-After'
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
                minimum: 1
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      operationId: getUsage
      summary: Get plan and usage
      tags:
      - Account
      description: Returns the team's plan, limits and usage in the current period.
    servers:
    - url: https://api.mepmail.dev
      description: MepMail Cloud
    - url: '{baseUrl}'
      description: Self-hosted instance
      variables:
        baseUrl:
          default: http://localhost:3001
  /deliverability:
    get:
      responses:
        '200':
          description: Account deliverability score over the trailing 30 days
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeliverabilityResponse'
              example:
                object: deliverability
                score: 1
                band: excellent
                content_score: 1
                outcome_score: 1
                complaint_rate: 1
                hard_bounce_rate: 1
                emails_sent: 1
                scored_recipients: 1
                window_days: 1
                insufficient_outcome_data: false
                guardrail_status: ok
                score_version: 1
        '401':
          description: Missing, malformed or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Restricted API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: 'Rate limit exceeded: 600 requests per minute per API key and 3,000 per team; wait for Retry-After'
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
                minimum: 1
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      operationId: getDeliverability
      summary: Get the deliverability score
      tags:
      - Account
      description: Returns the account's deliverability score over the trailing 30 days.
    servers:
    - url: https://api.mepmail.dev
      description: MepMail Cloud
    - url: '{baseUrl}'
      description: Self-hosted instance
      variables:
        baseUrl:
          default: http://localhost:3001
components:
  schemas:
    UsageResponse:
      type: object
      properties:
        object:
          type: string
          enum:
          - usage
        cloud:
          type: boolean
          description: True on MepMail Cloud, where plan limits apply
        plan:
          type:
          - string
          - 'null'
          enum:
          - free
          - starter
          - pro
          - scale
          - null
          description: Effective plan; null self-hosted or on the instance's own (system) team
        limits:
          type: object
          properties:
            emails_per_day:
              type:
              - integer
              - 'null'
              description: Daily cap (UTC day) on Free and Starter; null on monthly plans and self-hosted
            emails_per_month:
              type:
              - integer
              - 'null'
              description: Emails included per billing period on Pro and Scale; null on daily plans and self-hosted
            domains:
              type:
              - integer
              - 'null'
              description: null = unlimited or self-hosted
            contacts:
              type:
              - integer
              - 'null'
              description: Contacts the team may hold; null = unlimited or self-hosted
          required:
          - emails_per_day
          - emails_per_month
          - domains
          - contacts
        today:
          type: object
          properties:
            emails_sent:
              type: integer
              description: Emails accepted so far this UTC day
            resets_at:
              type: string
              description: Next UTC midnight, when the daily counter resets
          required:
          - emails_sent
          - resets_at
        period:
          type:
          - object
          - 'null'
          properties:
            emails_sent:
              type: integer
              description: Emails accepted so far this billing period
            included:
              type: integer
              description: Emails the plan includes per period
            overage_enabled:
              type: boolean
              description: Whether sends past `included` bill overage instead of being refused
            overage_usd_per_1k:
              type: number
              description: Overage price per 1,000 emails, in USD
            starts_at:
              type: string
              description: Billing period start
            ends_at:
              type: string
              description: Billing period end, when the counter resets
          required:
          - emails_sent
          - included
          - overage_enabled
          - overage_usd_per_1k
          - starts_at
          - ends_at
          description: Billing-period usage on monthly plans; null on daily plans and self-hosted
        team:
          type: object
          properties:
            id:
              type: string
              format: uuid
            name:
              type: string
          required:
          - id
          - name
        app_url:
          type:
          - string
          - 'null'
          description: Dashboard origin, for building links; null when unset
      required:
      - object
      - cloud
      - plan
      - limits
      - today
      - period
      - team
      - app_url
    UsageTermsUnavailable:
      allOf:
      - $ref: '#/components/schemas/ErrorResponse'
      - type: object
        properties:
          usage:
            type: object
            properties:
              today:
                type: object
                properties:
                  emails_sent:
                    type: integer
                    description: Emails accepted so far this UTC day
                  resets_at:
                    type: string
                    description: Next UTC midnight, when the daily counter resets
                required:
                - emails_sent
                - resets_at
              period:
                type:
                - object
                - 'null'
                properties:
                  emails_sent:
                    type: integer
                  included:
                    type: integer
                  overage_enabled:
                    type: boolean
                  starts_at:
                    type: string
                  ends_at:
                    type: string
                required:
                - emails_sent
                - included
                - overage_enabled
                - starts_at
                - ends_at
            required:
            - today
            - period
        required:
        - usage
    DeliverabilityResponse:
      type: object
      properties:
        object:
          type: string
          enum:
          - deliverability
        score:
          type:
          - number
          - 'null'
        band:
          type:
          - string
          - 'null'
          enum:
          - excellent
          - good
          - needs_attention
          - at_risk
          - null
        content_score:
          type:
          - number
          - 'null'
        outcome_score:
          type:
          - number
          - 'null'
        complaint_rate:
          type: number
        hard_bounce_rate:
          type: number
        emails_sent:
          type: integer
        scored_recipients:
          type: integer
        window_days:
          type: integer
        insufficient_outcome_data:
          type: boolean
        guardrail_status:
          type: string
          enum:
          - ok
          - warning
          - paused
        score_version:
          type: integer
      required:
      - object
      - score
      - band
      - content_score
      - outcome_score
      - complaint_rate
      - hard_bounce_rate
      - emails_sent
      - scored_recipients
      - window_days
      - insufficient_outcome_data
      - guardrail_status
      - score_version
    ErrorResponse:
      type: object
      properties:
        statusCode:
          type: number
        name:
          type: string
        message:
          type: string
      required:
      - statusCode
      - name
      - message
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: 'An API key from the dashboard (ms_…), sent as Authorization: Bearer. A sending-only key reaches the /emails routes only.'
x-refined-from:
- docs.json
- mepmail-dev-docs-openapi.json
x-provenance:
  method: harvested
  publisher: MepMail
  source: https://docs.mepmail.dev/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)