MepMail Account API
Plan, usage and deliverability of the team.
Plan, usage and deliverability of the team.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/mepmail-dev:mepmail-dev-account-api"
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.
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: 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)