GET /v1/emails/{email}/history

Family: Verification and finder · Operation ID: v1_email_history

Access

Workspace API key: Authorization: Bearer <key>. The key is scoped to its workspace; the backend checks operation permissions and quota.

Open history

Required scope: verify

Create a key in Developer settings. Set API_BASE_URL to the current app origin.

Request example

curl --fail-with-body -X GET "$API_BASE_URL/v1/emails/{email}/history" \
  -H "Authorization: Bearer $API_KEY"

Replace each {parameter} segment in the path with its URL-encoded value.

Parameters

[
  {
    "description": "Email address to look up",
    "in": "path",
    "name": "email",
    "required": true,
    "schema": {
      "type": "string"
    }
  },
  {
    "in": "query",
    "name": "limit",
    "required": false,
    "schema": {
      "format": "int64",
      "type": "integer"
    }
  }
]

Responses

{
  "content": {
    "application/json": {
      "schema": {
        "properties": {
          "email": {
            "type": "string"
          },
          "history": {
            "items": {
              "$ref": "#/components/schemas/HistoryEntry"
            },
            "type": "array"
          },
          "total": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "email",
          "history",
          "total"
        ],
        "type": "object"
      }
    }
  },
  "description": "Verification history for the email"
}

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ErrorEnvelope"
      }
    }
  },
  "description": "Request error"
}

Download the full OpenAPI contract