FAfax
Fax AI

Trigger fax field extraction

Trigger AI field extraction for a fax. Extracts structured data fields from the fax content. If extraction is already finished, returns the existing result. Consumes AI credits. (Permitted scopes: fax:all:edit, fax:ai:edit)

post/accounts/{user_id}/faxes/{fax_id}/ai/field-extraction

Request

  • Base URL
    https://restapi.fax.plus/v3
  • URL
    https://restapi.fax.plus/v3/accounts/{user_id}/faxes/{fax_id}/ai/field-extraction
  • Auth
    • OAuth 2
      Authorization code: https://accounts.fax.plus/login?response_type=code&client_id=YOUR_CLIENT_ID&redirect_uri=http://localhost&scope=all
      Token URL: https://accounts.fax.plus/token scopes: all
    • or HTTP bearer

Path parameters

user_idstring required

User ID. Use 'self' for your own account, or provide a specific user ID for corporate member accounts.

fax_idstring required

The unique identifier of the fax

Response

Response containing field extraction status and result

status'not_requested' | 'pending' | 'finished' | 'failed' | 'content_filtering_policy' required

Field extraction processing status

dataobject nullable

Extracted fields as key-value pairs. Null when status is not finished

Example response

{
  "status": "finished",
  "data": {
    "sender_name": "John Doe",
    "sender_company": "Acme Corp",
    "date": "2026-01-15",
    "reference_number": "INV-2026-001"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.