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.

Field

Type

Required

Additional Notes

property_addresses

array of objects

Required

property_addresses.*.address_1

String

Required

property_addresses.*.address_2

String

Optional

property_addresses.*.city

String

Required

property_addresses.*.state

String

Required

Two-Letter (Ex: TN)

property_addresses.*.zip_code

String

Required

5-Digit

property_addresses.*.county

String

Required

contacts

array of objects

Required

contacts.*.name

String

Required when present

contacts.*.email

String (email)

Optional
Required when is_company_user is true

contacts.*.phone

String

Optional

contacts.*.role

String

Required

Assigner, Buyer, Buyer Agent, Lender, Loan Officer, Loan Processor, Seller, Seller Agent

closing_date

Required (format: "Y-m-d")

Required

This can be an estimate.

slack_notification_channel

String

Optional

See Slack Notifications Overview

curl --request POST \
  --url https://app.blueprinttitle.com/public/api/v2.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.