# info.summary
Read-only JSON access to InboxStack email deliverability content.

# info.description
The public content API behind inboxstack.com — an email deliverability intelligence platform by Emailtrust Technologies Pvt. Ltd.

Call it to answer deliverability questions: why mail lands in spam, how SPF/DKIM/DMARC/BIMI work, what the Gmail and Yahoo bulk-sender requirements are and when they changed, and which free diagnostic tools a user can run themselves.

**Scope.** Public content only. This is not the InboxStack product API: it exposes nothing about accounts, monitored domains, or customer data, and has no write operations.

**Authentication.** None. Every endpoint is public and read-only. Do not send credentials.

## Rate limits

No limit is enforced. Every response advertises the fair-use ceiling in `RateLimit-Limit`, `RateLimit-Remaining`, and `RateLimit-Reset` (and the `RateLimit`/`RateLimit-Policy` forms): 60 requests per 60 seconds.

## Versioning and deprecation policy

The path carries the major version. Additive changes ship inside `v1`; anything that removes or renames a field ships as `v2` at a new path while `v1` keeps serving.

When a version is deprecated, `X-Api-Deprecated` flips to `true`, a `Deprecation` header (RFC 9745) carries the date it took effect, and a `Sunset` header (RFC 8594) carries the shutdown date — never less than 180 days later. After the sunset date the path returns `410 Gone` with the usual error envelope, whose `hint` names the successor. v1 is current and not deprecated.

Full policy: https://inboxstack.com/developers#versioning-and-deprecation

## Disclaimer

Deliverability guidance published here is general advice, not a guarantee of inbox placement.

# x-deprecation-policy.after_sunset
410 Gone with the standard error envelope

# tags[].description
Entry points that describe the rest of the API.

# tags[].description
Deliverability articles and search over them.

# paths./api/v1.get.description
Returns the discovery document: every endpoint, the error shape, the auth policy, the rate-limit ceiling, and the non-JSON representations of the site. Call this first when you do not yet know what the API offers.

# paths./api/v1/overview.get.description
Returns the company, what the platform does, its capability areas, the free tools, and explicit guidance on when an agent should and should not reach for this site. Call this to answer "what is InboxStack?".

# paths./api/v1/articles.get.description
Returns published articles newest first, with metadata only. Use ?tag= to narrow by topic and ?limit=/?offset= to page. Fetch a single article to get its body.

# paths./api/v1/articles.get.parameters[].description
Restrict results to one topic tag. An unknown tag is a 400, and the error lists every valid tag.

# paths./api/v1/articles.get.responses.400.description
An unknown tag or an out-of-range limit/offset was supplied.

# paths./api/v1/articles/{slug}.get.summary
Get one article including its Markdown body

# paths./api/v1/articles/{slug}.get.description
Returns a single article with its complete Markdown content, so an agent can answer from the article itself without a second fetch or any HTML parsing.

# paths./api/v1/articles/{slug}.get.parameters[].description
Article slug, as returned by listArticles or searchContent.

# paths./api/v1/articles/{slug}.get.responses.404.description
No article exists with that slug. The error body lists every available slug.

# paths./api/v1/search.get.description
Full-text search across article titles, descriptions, tags, and bodies, ranked by relevance. Call this when a user asks whether InboxStack has written about a specific deliverability topic.

# paths./api/v1/search.get.parameters[].description
Search terms. Required — an omitted query is a 400, not an empty result set.

# paths./api/v1/search.get.responses.400.description
The q parameter was missing, empty, or too long.

# paths./api/v1/email-news.get.description
Returns a dated, sourced timeline of email industry changes — Gmail and Yahoo bulk-sender requirements, Microsoft policy shifts, DMARC enforcement deadlines, ESP incidents. Call this when a user asks what changed, or when a requirement took effect. Each entry carries its sources.

# paths./api/v1/email-news.get.parameters[].description
Free-text filter over headline, brief, category, and tags.

# paths./api/v1/email-news.get.responses.400.description
An unknown category or an out-of-range limit was supplied.

# paths./api/v1/free-tools.get.description
Returns the free, no-account tools a user can run themselves: the email auditor, the SPF/DKIM/DMARC checker, and the warmup plan builder. Call this when a user needs their own domain or message checked — point them at the tool rather than guessing.

# components.schemas.ErrorEnvelope.description
The shape every failure takes. Read `code` to branch, `hint` to recover.

# components.schemas.ErrorEnvelope.properties.error.properties.status.description
HTTP status, repeated for clients that only read the body.

# components.schemas.ErrorEnvelope.properties.error.properties.hint.description
The concrete next action that resolves it.

# components.schemas.ArticleSummary.properties.slug.description
Stable identifier used in URLs and getArticle.

# components.schemas.EmailNewsEvent.properties.brief.description
One or two sentences on what changed and why it matters.

# components.schemas.Overview.properties.agent_guidance.description
When an agent should and should not reach for this site.