Bird Email Inbox Insights API

Inbox placement, seed tests, and sending reputation for the workspace's own sending domains, measured from a panel of real mailboxes. Rates here are percentages carrying a `_percent` suffix (`87.4`). Competitive Insights reports the same kind of figure as a fraction (`0.874`), so a client reading both products scales one of them.

GitHub OpenAPI

Operations 12

GET /v1/email/inbox-insights/placement Get inbox placement for a sending domain #
GET /v1/email/inbox-insights/authentication Get email authentication standing for a sending domain #
GET /v1/email/inbox-insights/complaints Get the Google-reported spam rate for a sending domain #
GET /v1/email/inbox-insights/spam-traps Get spam-trap hits for a sending domain #
GET /v1/email/inbox-insights/blocklists Check whether a sending domain's infrastructure is blocklisted #
GET /v1/email/inbox-insights/benchmarks/industry Get the industry placement benchmark for a sending domain #
GET /v1/email/inbox-insights/seed-tests Get seed tests for a sending domain #
POST /v1/email/inbox-insights/seed-tests Register a seed test and get its addresses #
GET /v1/email/inbox-insights/seed-tests/configuration Get the choices available for a new seed test #
GET /v1/email/inbox-insights/domains List sending domains and their Inbox Insights status #
PATCH /v1/email/inbox-insights/domains/{sending_domain} Switch Inbox Insights on or off for a sending domain #
POST /v1/email/inbox-insights/domain-monitoring Switch Inbox Insights on for the workspace's main sending domain #

Documentation

Specifications

Other Resources

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/bird:bird-email-inbox-insights-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

bird-email-inbox-insights-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Bird Email Inbox Insights API
  version: 1.0.0
  description: 'Build communications into your applications and AI workflows with the Bird API.

    Explore endpoints for email, SMS, WhatsApp, verification, and realtime messaging.


    Start with the developer documentation, browse the

    API reference, or connect your agent through the

    Bird MCP server.


    Setting a `User-Agent` header is recommended but not required. Official Bird

    SDKs set it automatically (format: `bird-/`). The header is

    used for operational logging and customer-support diagnostics; the API never

    rejects requests that omit it.


    Rate limits are advertised on every response from a rate-limited endpoint as

    IETF `RateLimit` and `RateLimit-Policy` headers (Structured Fields per RFC

    9651; spec draft-ietf-httpapi-ratelimit-headers-11). On 429 responses, a

    `Retry-After` header in seconds is also returned. Clients should pace

    themselves against the `r` (remaining) and `t` (seconds until reset) params

    in the `RateLimit` header rather than only reacting to 429s.


    The deprecation policy explains how

    the API marks a deprecated field, query parameter, or body shape, including

    the `Deprecation` response header (RFC 9745).'
servers:
- url: https://{region}.platform.bird.com
  description: 'Regional API endpoint. Use the host for the region your organization is hosted in. Official Bird SDKs and the CLI select it automatically from your API key, so you rarely need to set it by hand.

    '
  variables:
    region:
      default: us1
      enum:
      - us1
      - eu1
      description: The region your organization's data is hosted in.
- url: https://platform.bird.com
  description: Region-independent endpoint for authentication and account administration.
- url: http://localhost:8080
  description: Local development.
security:
- BearerAuth: []
tags:


# --- truncated at 32 KB (148 KB total) ---
# Full source: https://artifacts.apis.io/bird/openapi/bird-email-inbox-insights-api-openapi.yml