Webhooks facilitate real-time data exchange between applications. We utilize inbound and outbound webhooks to ensure seamless integration between AFX and your platform for title research order placement, cross-platform support communication, and title report delivery. When successfully integrated with us, your clients or representatives will be able to easily place, pause, cancel, and receive orders, as well as communicate with us when needed, without ever leaving your software.
Notably, integration will also give your IT team access to additional automations within your own software downstream from report delivery. While we always deliver a PDF version (and optionally Word & Excel versions) of our report, our API also includes a JSON object within the delivery payload. This JSON object contains the same data that is available in the PDF version of our title abstract, but is packaged as pure text in a computationally digestible format.
JSON empowers your devops team with the ability to programmatically and accurately analyze the provided report data, and take additional actions within your software based on key variables provided. Depending on your industry, this might include automatically pausing or releasing funds contingent upon whether owner names match your system, any involuntary liens have been found, a satisfaction is recorded, or environmental hazards place conditions on the use of property.
Clients that have taken advantage of integration with us have reduced human error, nearly eliminated order management time, and have increased the speed in which loan funding and legal cases are resolved accurately.
To integrate AFX with third-party systems using webhooks, users need a secure HTTPS server, token-based authentication, and a solid grasp of JSON, web development, and a programming language. Familiarity with API testing tools like Postman and proper setup of webhook endpoints, data handling, and logging are also essential.
Webhooks enable real-time interaction between AFX and external systems. For instance, an inbound "property.add" webhook can trigger a property search, followed by an outbound "property.status.update" webhook to confirm receipt and status.
AFX Research's webhook integration streamlines property report management through a simple, real-time process. It starts with a "property.add" webhook to initiate the order, followed by status updates via "property.status.update," and concludes with the "property.document.upload" webhook delivering the final report and an "Order Complete" confirmation.
To ensure security, all webhook communication must use HTTPS and include a valid token in the "Authorization" header for inbound requests. AFX verifies this token, and it's recommended that your system also authenticates outbound webhooks to confirm their legitimacy.
AFX offers testing options for both inbound and outbound webhooks using the "is\_test" parameter to simulate processing without charges. Users can test inbound requests via their system or Postman, and send outbound tests from the AFX API settings, with the 10 most recent webhooks available for review and troubleshooting.
{
"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"
}
}