Integration Process

Key Features, Security, & Testing Overview

Connect your systems to AFX two complementary ways: a REST API for querying and managing orders on demand, and webhooks for real-time notifications as your properties progress. Most clients use both together for seamless, real-time data exchange.

AFX API integration overview

Connect Your Systems to AFX

Once integrated, your team and clients can place, pause, cancel, and receive title research orders — and communicate directly with AFX support — all without leaving your platform.

Every order is delivered with a PDF report (plus optional Word and Excel versions), but our API also includes a structured JSON object in the delivery payload. This JSON contains the same data found in your title abstract, packaged as machine-readable text rather than a static document.

That structure gives your DevOps team the ability to programmatically and accurately act on key variables the moment a report is delivered — for example, automatically pausing or releasing funds based on whether:

  • Owner names match your system's records
  • Involuntary liens have been found
  • A satisfaction has been recorded
  • Environmental hazards impose conditions on the property's use

The result: clients who integrate with AFX have reduced human error, nearly eliminated manual order management time, and sped up accurate loan funding and legal case resolution.

Webhook lifecycle

How a Title Order Flows, End to End

Webhooks enable real-time interaction between AFX and external systems — inbound webhooks send data to AFX, outbound webhooks return status and deliverables to you.

  1. property.add

    Initiate the search

    Your platform sends an inbound property.add webhook (or an API call) to open the order — one click, no copy/paste.

  2. 200 · Order Received

    Instant confirmation

    AFX returns a confirmation status so your system knows the order is in motion.

  3. property.status.update

    Processing updates

    Outbound status webhooks keep your LOS or dashboard current while research completes.

  4. property.document.upload

    Report delivery

    The final report arrives — PDF plus a structured JSON abstract — followed by an “Order Complete” confirmation.

Security & authentication

All webhook communication must use HTTPS and include a valid token in theAuthorization header for inbound requests. AFX verifies this token, and we recommend your system also validates outbound webhooks with the same token to confirm requests from AFX are legitimate.

  • HTTPS encryption on every exchange
  • Token-based authentication
  • Mutual validation of tokens between systems

Testing & monitoring

Test inbound and outbound webhooks using the is_test parameter to simulate processing without charges. Send inbound tests from your system or Postman, trigger outbound tests from the AFX API settings, and review the 10 most recent webhooks for troubleshooting.

  • Sandbox-style test orders with is_test
  • Inbound & outbound webhook logs
  • Works with Postman and standard API tooling

What your team needs

Integration Prerequisites

To integrate AFX with third-party systems using webhooks, your team needs a secure HTTPS server, token-based authentication, and a working knowledge of JSON and web development.

Webhook basics

Familiarity with webhooks, web development, and JSON payload handling.

HTTPS + tokens

A secure HTTPS endpoint and token-based authentication on both directions.

Language of choice

Proficiency in a programming language and API tools like Postman.

Logging & monitoring

Endpoint logging and monitoring so every event is traceable end to end.

Example abstract payload

What Your System Receives

The same data as the PDF abstract — taxes, deeds, mortgages, liens — delivered as structured JSON your platform can act on the moment it arrives.

title-abstract-payload.json
{
  "your_order_number": "1663232-1212",
  "afx_property_id": "79-275248-47",
  "file_name": "1663232-1212-TS.pdf",
  "public_url_to_file": "https://ourfileurl.com/files/download/431365FR2aPVJhUTIs6K4emWn7LPN5RGDvrT1WtQAHRKE3g",
  "report_data": {
    "productID": "116",
    "productName": "Current Owner Search w/ Taxes",
    "propertyID": "79-275248-47",
    "yourReferenceNumber": "ABCD1234",
    "yourOrderNumber": "1663232-1212",
    "yourMortgageeSiteName": "ABC MONEYSOURCE MORTGAGE COMPANY",
    "dateComplete": "08/19/2024",
    "dateEffective": "08/16/2024",
    "propAddress": "123 SE TEST ROAD",
    "propCity": "ESTACADA",
    "propState": "OR",
    "propZip": "97020",
    "propCounty": "CLACKAMAS",
    "propAPN": "111025371-012",
    "propAltAPN": "R-3-4E-21-C-A-01500",
    "propLegal": "SUBDIVISION VISTA TEST 4366 TRACT C",
    "propOwner": "CORY TIPTON",
    "landValue": "100000.00",
    "buildingValue": "250000.00",
    "propValue": "350000.00",
    "overallTaxNotes": "",
    "taxesExists": 1,
    "taxes": [
      {
        "year": "2023",
        "period": "",
        "status": "PAID",
        "date": "",
        "amount": "3141.26"
      },
      {
        "year": "2024",
        "period": "",
        "status": "DUE",
        "date": "",
        "amount": "3721.10"
      }
    ],
    "deedsExists": 1,
    "deeds": [
      {
        "type": "WARRANTY DEED",
        "dated": "03/13/2024",
        "recorded": "03/13/2024",
        "instrument": "2024-008696",
        "book": "",
        "page": "",
        "torrens": "",
        "grantorName": [
          "NORTHWEST CORE HOLDINGS, LLC"
        ],
        "granteeName": [
          "CORY TIPTON"
        ],
        "notes": ""
      },
      {
        "type": "DEED",
        "dated": "01/31/2024",
        "recorded": "02/02/2024",
        "instrument": "2024-003832",
        "book": "",
        "page": "",
        "torrens": "",
        "grantorName": [
          "VISTA TEST HOMEOWNER'S ASSOCIATION"
        ],
        "granteeName": [
          "JOHN DOE"
        ],
        "notes": ""
      }
    ],
    "mortgagesExists": 1,
    "mortgages": [
      {
        "type": "DEED OF TRUST",
        "dated": "04/20/2024",
        "recorded": "04/30/2024",
        "instrument": "2024-015037",
        "book": "",
        "page": "",
        "amount": "312000.00",
        "mortgagorName": "JOHN DOE",
        "mortgageeName": "ABC MONEYSOURCE MORTGAGE COMPANY",
        "trusteeName": "FIDELITY NATIONAL TITLE COMPANY OF OREGON",
        "mersName": "EVERGREEN MONEYSOURCE MORTGAGE COMPANY",
        "mersMIN": "1000235-0023016999-7",
        "mersStatus": "ACTIVE",
        "relatedDocsExists": 1,
        "relatedDocs": [
          {
            "type": "ASSIGNMENT",
            "desc": "UMB BANK NATIONAL",
            "recorded": "02/28/2024",
            "instrument": "",
            "book": "1130",
            "page": "415"
          }
        ],
        "notes": ""
      },
      {
        "type": "HELOC",
        "dated": "06/25/2024",
        "recorded": "06/30/2024",
        "instrument": "2024-016054",
        "book": "",
        "page": "",
        "amount": "30000.00",
        "mortgagorName": "JOHN DOE",
        "mortgageeName": "TRUST CREDIT UNION",
        "trusteeName": "",
        "mersName": "",
        "mersMIN": "",
        "mersStatus": "",
        "relatedDocsExists": 0,
        "notes": ""
      }
    ],
    "liensExists": 0,
    "overallLienNotes": "",
    "miscsExists": 0,
    "reportNotes": "",
    "dateSubmitted": "08/19/2024 10:14:31 AM",
    "currentDeedRecordDate": "03/13/2024"
  }
}

Start with a test webhook today

Our DevOps team can have most platforms fully integrated in less than a day — documentation, payload examples, and sandbox testing included.