Create a Refinance Transaction/Order

While not all fields are required, we encourage you to send over as much information as possible so that we can begin processing your order as soon as possible.

Refinance Contacts:
Refinance transaction can accept Buyer, Buyer Agent, Lender, Loan Officer, or Loan Processor contacts.

When submitting a contact that is part of your organization, you should include "is_company_user": true. At least one "company user" is required, and must include an email. All Lender, Loan Officer, or Loan Processor contacts must be company users.

All Buyer or Buyer Agent contacts must be submitted with "is_company_user": false and may optionally include an email.

FieldTypeRequired?Additional Notes
property_addressobjectRequired
property_address.address_1StringRequired
property_address.address_2StringOptional
property_address.cityStringRequired
property_address.stateStringRequiredTwo-Letter (Ex: MA)
property_address.zip_codeStringRequired5-Digit
property_address.countyStringRequired
contactsarray of objectsRequired
contacts.*.nameStringRequired when present
contacts.*.emailString (email)Optional, Required when is_company_user is true
contacts.*.phoneStringOptional
contacts.*.roleStringRequiredBuyer, Buyer Agent, Lender, Loan Officer, Loan Processor
contacts.*.is_company_userBooleanRequiredtrue for Lender, Loan Officer, Loan Processor

false for Buyer, Buyer Agent
closing_datedate (Format: "Y-m-d")Required
loan_detailsobjectRequired
loan_details.lenders_loan_idStringOptional
loan_details.amountInteger (in cents)Optional$400,000 becomes 40000000
loan_details.rate_typeStringOptional
loan_details.mortgageStringOptional
slack_notification_channelStringOptionalSee Slack Notifications Overview
curl --request POST \
  --url https://app.blueprinttitle.com/public/api/v4.0.0/transactions/refinances \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer 2|fa1CXjgluUt5ma9o01A79LQC9N1VkKQDopT6uVhr' \
  --header 'Content-Type: application/json' \
  --data '{
    "property_address" : {
      "address_1": "123 Main St",
      "city": "Nashville",
      "state": "TN",
      "zip_code": "12345",
      "county": "Davidson"
    },
    "contacts" : [
        {
          "name": "John Doe",
          "email": "[email protected]",
          "phone": "1234567890",
          "role": "Buyer",
          "is_company_user": false
        },
        {
          "name": "Bob Loblaw",
          "email": "[email protected]",
          "phone": "1234567890",
          "role": "Lender",
          "is_company_user": true
        }
    ],
    "loan_details" : {
        "lenders_loan_id" : "3474341692",
        "amount" : 439930,
        "rate_type" : "Conventional 30 - year fixed",
        "mortgage" : "Quicken Loans LLC ISAOA\n1050 Woodward Ave.\nDetroit, MI 48226"
    },
        "closing_date": "2021-06-15"
}'

Response

{
  "order_id": "717b72fd-e3c7-4c7a-a80b-1fc2e5033201"
}

You should store the order_id locally in order to track Callbacks, upload, view & download related Documents, and other operations related to the Transaction / Order.