Store a Purchase Transaction/Order

Below are the fields available when creating a new transaction/order. While not all fields are required, the more information that is provided, the faster we can begin processing your transaction.

Purchase Contacts
Purchase transactions can accept Assigner, Buyer, Buyer agent, Lender, Loan Officer, Loan Processor, Seller, or Seller Agent 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.

FieldTypeRequiredAdditional Notes
property_addressesarray of objectsRequired
property_addresses.*.address_1StringRequired
property_addresses.*.address_2StringOptional
property_addresses.*.cityStringRequired
property_addresses.*.stateStringRequiredTwo-Letter (Ex: TN)
property_addresses.*.zip_codeStringRequired5-Digit
property_addresses.*.countyStringRequired
contactsarray of objectsRequired
contacts.*.nameStringRequired
contacts.*.emailString (email)Optional
Required when is_company_user is true
contacts.*.phoneStringOptional
contacts.*.roleStringRequiredAssigner, Buyer, Buyer Agent, Lender, Loan Officer, Loan Processor, Seller, Seller Agent
contacts.*.is_company_userBooleanRequiredtrue for Lender, Loan Officer, Loan Processor

false for Buyer, Buyer Agent, Seller, Seller Agent
closing_dateDate (format: "Y-m-d")RequiredThis can be an estimate.
slack_notification_channelStringOptionalSee Slack Notifications Overview
purchase_priceInteger (in cents)Required$400,000 becomes 40000000
funding_typeStringOptional, defaults to CashCash, Loan
loan_amountInteger (in cents)Optional, required if funding_type is Loan$400,000 becomes 40000000
purchase_typeStringOptional, defaults to 'Standard'Standard, Assigmment, Double Close A-B, Double Close B-C
curl --request POST \
  --url https://app.blueprinttitle.com/public/api/v4.0.0/transactions/purchases \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer 2|fa1CXjgluUt5ma9o01A79LQC9N1VkKQDopT6uVhr' \
  --header 'Content-Type: application/json' \
  --data '{
    "property_addresses" : [
        {
          "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": true
        },
        {
          "name": "Bob Loblaw",
          "email": "[email protected]",
          "phone": "1234567890",
          "role": "Seller",
          "is_company_user": false
        }
    ],
    "closing_date" : "2022-01-01",
    "is_assignment" : false
}'

Response

{
  "order_id": "91deb032-de50-434f-a6a5-b9cb05d58a71"
}

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.