> ## Documentation Index
> Fetch the complete documentation index at: https://mintfax.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# fax.delivered

> Sent when a fax has been successfully delivered.

## When it fires

Exactly once, when a delivery attempt has been confirmed successful by the carrier. The credit hold is captured into a posted charge at this moment.

The full `attempts[]` history is included, with the final successful attempt as the last entry. `error_code` and `error_message` are null on the top-level payload (a previous failed attempt may still have its own `error_code` inside `attempts[]`).

## What your handler should do

* Mark the originating business object as complete.
* The `pages` field is the count actually transmitted. Use it for itemized billing or audit, not the page count you submitted.
* `fax.delivered` and `fax.failed` are mutually exclusive. Once you receive one, do not expect the other.
* Deduplicate on `webhook-id` if you persist completion state. mintfax may retry the delivery of this webhook itself if your endpoint returned non-2xx earlier; the event ID stays the same across retries.


## OpenAPI

````yaml openapi.json webhook fax.delivered
openapi: 3.1.0
info:
  title: mintfax API
  version: '1.0'
  description: >-
    Developer-first fax API. Send faxes with a single API call.


    ## Authentication


    Most endpoints require a Bearer token in the `Authorization` header.


    - **Account keys** (`mfx_acct_...`) access account-level endpoints
    (`/account`, `/account/balance`, `/account/transactions`, `/account/keys`).

    - **Environment keys** (`mfx_test_...` for test, `mfx_live_...` for live)
    access operational endpoints (`/environment`, `/faxes`, `/webhooks`,
    `/events`).

    - Registration endpoints (`POST /account/register` and `POST
    /account/register/verify`) do not require authentication.


    ## Base URL


    All API requests use `https://api.mintfax.com/v1` as the base URL.
  contact:
    name: mintfax Support
    email: support@mintfax.com
    url: https://mintfax.com/docs
servers:
  - url: https://api.mintfax.com/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Account
    description: >-
      Account-level resources: registration, account info, balances, and API
      keys.
  - name: Environment
    description: >-
      Test and live environment configuration shared across all operational
      requests.
  - name: Fax
    description: Send, list, retrieve, resend, and purge faxes.
  - name: Events
    description: >-
      Read the immutable event log for everything that has happened in the
      environment.
  - name: Webhooks
    description: >-
      Manage webhook endpoints and inspect or replay individual delivery
      attempts.
paths: {}
components:
  securitySchemes:
    bearerAuth:
      type: http
      description: |-
        API key as Bearer token. Use an account key (`mfx_acct_...`) for
        `/account/*` endpoints, and an environment key (`mfx_test_...` for
        sandbox, `mfx_live_...` for live) for `/environment/*`, `/faxes`,
        `/webhooks`, and `/events`.
      scheme: bearer

````