This summary provides an overview of integrating the AFX Research System with third-party platforms using inbound and outbound webhooks. Webhooks facilitate real-time data exchange between applications. The content outlines the steps for setting up, configuring, and utilizing webhooks to ensure seamless communication between AFX and external systems.
{
"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": "",
"taxExists": 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",
"mostRecentDeedRecorded": "03/13/2024"
}
}
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.
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.
Key benefits to integration include:
Our API integration environment includes:
{ "event_name": "property.document.upload", "webhook_sent_at": "2024-05-21 09:05:58", "data": { "your_order_number": "1663232-1212", "afx_property_id": "79-275248-47", "file_name": "Property Search.pdf", "public_url_to_file": "https://domain.com/path/to/public/file.pdf", "report_data": "is_test": 0 } }
{
"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": "",
"taxExists": 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",
"mostRecentDeedRecorded": "03/13/2024"
}
}
To integrate AFX with third-party systems using webhooks, users need a basic understanding of webhooks, web development, and the JSON format. A secure server with HTTPS and token-based authentication is essential. Proficiency in a web development programming language and familiarity with API testing tools, such as Postman, are also required. Users must configure webhook endpoints, process data securely, and set up logging to monitor and troubleshoot webhook activity.
Webhooks allow AFX to interact with external systems in real time. Inbound webhooks let external platforms send data to AFX, while outbound webhooks enable AFX to notify external systems of certain events. For example, a client may initiate a property search via an inbound "property.add" webhook, and AFX will respond with an outbound "property.status.update" webhook to confirm the request was received.
The webhook integration with AFX Research follows a straightforward process for efficient property report management. It begins with initiating the search via the "property.add" webhook, after which a 200 HTTP status confirms receipt of the order with an "Order Received" message. Updates are provided throughout processing, such as with the "property.status.update" webhook, ensuring real-time progress tracking. Upon report completion, the "property.document.upload" webhook delivers the final document, concluding with a final "Order Complete" status to signify successful fulfillment.
To ensure security, all webhook communication must use HTTPS encryption, and inbound webhooks require a valid token in the request headers. The token can be accessed in your AFX API settings and should be included in the "Authorization" header of all inbound requests. AFX will verify the token, and it is recommended that your system validates outbound webhooks to confirm authenticity.
AFX provides testing options for both inbound and outbound webhooks. The "is_test" parameter can be set to "1" to simulate processing without actual charges. For inbound webhook tests, users can send requests via their system or tools like Postman, with helpful resources provided by AFX. For outbound webhooks, users can click a "Send Test Webhook" button within the AFX API settings to send a test to the configured URL. The 10 most recent inbound and outbound webhooks are available for review to assist in 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"
}
}