Free Email Spam Tester Inbox placement API

openapi: 3.2.0
info:
  title: Email Spam Tester Inbox placement API
  description: 'Test an email before you send it to anybody.


    The loop is three calls. Ask for an address, send the message you were about to

    send your list to that address, then read the report. No key, no account, no

    limit per person on the first 100,000 reports.


    curl -X POST https://email-spam-tester.com/api/v1/inbox

    # send your message to the address it returns, then:

    curl https://email-spam-tester.com/api/v1/tests/


    The address accepts exactly one message and expires after an hour. The report

    link is permanent and carries `report_url` inside the JSON, so a forwarded

    report still says where it came from.


    **Poll `/status`, not `/`.** The full report is several thousand lines of JSON

    and the analysis takes a few seconds; the status endpoint is the cheap way to

    find out whether it is worth fetching yet. `analysis_status` reaches

    `checks_ready` first and the AI plan lands a minute or so later under

    `ai_status`, so a caller that only wants the checks does not have to wait for

    the plan.


    **Agents:** there is an MCP server at `/mcp` with the same capability and a

    blocking wait, which is a better fit than polling from a model.


    Every finding carries `citations`: the section of the RFC it comes from, quoted,

    and the page where Google states its own requirement. Those are curated by hand

    rather than generated, so they can be relied on.'
  contact:
    name: Email Spam Tester
    url: https://email-spam-tester.com/
  version: 1.0.0
tags:
- name: Inbox placement
paths:
  /api/v1/placement/availability:
    get:
      tags:
      - Inbox placement
      summary: Availability
      operationId: availability_api_v1_placement_availability_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /api/v1/placement:
    post:
      tags:
      - Inbox placement
      summary: Create
      operationId: create_api_v1_placement_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatePlacement'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/placement/by-score/{score_slug}:
    get:
      tags:
      - Inbox placement
      summary: Report For Score
      operationId: report_for_score_api_v1_placement_by_score__score_slug__get
      parameters:
      - name: score_slug
        in: path
        required: true
        schema:
          type: string
          title: Score Slug
      - name: soft
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Soft
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/placement/{slug}:
    get:
      tags:
      - Inbox placement
      summary: Report
      operationId: report_api_v1_placement__slug__get
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
          title: Slug
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    CreatePlacement:
      properties:
        public_results_accepted:
          type: boolean
          title: Public Results Accepted
          default: false
        score_slug:
          anyOf:
          - type: string
            maxLength: 64
            minLength: 1
            pattern: ^[A-Za-z0-9_-]+$
          - type: 'null'
          title: Score Slug
        account:
          anyOf:
          - type: string
            maxLength: 64
            minLength: 1
            pattern: ^[A-Za-z0-9_-]+$
          - type: 'null'
          title: Account
      type: object
      title: CreatePlacement