True Owner Documentation

Purpose

The purpose of this API is to uncover contact information so that one can get to the decision-makers with ease. True Owner information can be elusive, especially at the national level. LightBox has curated one of the largest sets of commercial property contact information available.  Once a property is identified the next question is how do I get in contact with the owner. This is where the True Owner API comes in. 

Swagger: OAS 3.1 Specification

Features

• Query property contacts using an address to return all property contacts on matched address results.
• Pass in a LightBox assessment ID to return allproperty contacts related to that assessment record.
• Pass in a LightBox parcel ID to return allproperty contacts of an assessment record tied to that parcel.
• Pass in a LightBox structure ID to return all matched property contacts on that structure.
• Pass in a LightBox address ID to return all matched property contacts related to that address.
• Pass in a Lightbox Contact ID to return all assessments with the passed property contact.

API Requests

Get Property Contacts by Address

Return property contact records that are related to an address.

GET /property-contacts/address?text={text}

Example Requests

curl -X GET -H ‘x-api-key: (api_key)’ https://api.lightboxre.com/v1/property-contacts/address?text=5201 California Ave, Irvine CA

https://api.lightboxre.com/v1/property-contacts/address?text=5201 California Ave, Irvine CA

Response

Media type: application/json

Get Property Contacts by Business Entity

Return property contact records that are related to a business entity.

GET /property-contacts/business-entities?name={name}&matchType={matchType}

Example Requests

curl -X GET -H ‘x-api-key: (api_key)’ https://api.stage.corp.lightboxre.com/v1/property-contacts/business-entities?name=VICALE%20LLC&matchType=exact

https://api.stage.corp.lightboxre.com/v1/property-contacts/business-entities?name=VICALE%20LLC&matchType=exact

Response

Media type: application/json

Get Property Contacts by Contact ID

Return all property contact records associated with a particular contact.

GET /property-contacts/contact/{id}

Example Requests

curl -X GET -H ‘x-api-key: (api_key)’ https://api.stage.corp.lightboxre.com/v1/property-contacts/contact/1201ML27JKRDUBSZTJDMU2

https://api.stage.corp.lightboxre.com/v1/property-contacts/contact/1201ML27JKRDUBSZTJDMU2

Response

Media type: application/json

Get Property Contacts by Address ID

Return property contact records that are related to an address identified by the LightBox Address ID.

GET /property-contacts/_on/address/us/{id}

Example Requests

curl -X GET -H ‘x-api-key: (api_key)’ https://api.lightboxre.com/v1/property-contacts/_on/address/us/0604YLLT99JMIUM595E4XT

https://api.lightboxre.com/v1/property-contacts/_on/address/us/0604YLLT99JMIUM595E4XT

Response

Media type: application/json

Get Property Contacts by Parcel ID

Return property contact records that are on a parcel using the LightBox Parcel ID.

GET /property-contacts/_on/parcel/us/{id}

Example requests

curl -X GET -H ‘x-api-key: (api_key)’ https://api.lightboxre.com/v1/property-contacts/_on/parcel/us/02034UK8D0FPUGRCMY8L76

https://api.lightboxre.com/v1/property-contacts/_on/parcel/us/02034UK8D0FPUGRCMY8L76

Response

Media type: application/json

Get Property Contacts by Structure ID

Return property contact records that are on a structure using the LightBox Structure ID.

GET /property-contacts/_on/structure/us/{id}

Example requests

curl -X GET -H ‘x-api-key: (api_key)’ https://api.lightboxre.com/v1/property-contacts/_on/structure/us/050172LL8ZS2SXELX0FRE0

https://api.lightboxre.com/v1/property-contacts/_on/structure/us/050172LL8ZS2SXELX0FRE0

Response

Media type: application/json

Get Property Contacts by Assessment ID

Return property contact records that are related to an assessment using the LightBox Assessment ID.

GET /property-contacts/_on/assessment/us/{id}

Example requests

curl -X GET -H ‘x-api-key: (api_key)’ https://api.lightboxre.com/v1/property-contacts/_on/assessment/us/03029JH5KG17JF5Y10YBHT

https://api.lightboxre.com/v1/property-contacts/_on/assessment/us/03029JH5KG17JF5Y10YBHT

Response

Media type: application/json

API Response

For each endpoint other than the tile requests, the response will stay consistent. 

{
  "_links": {
    "self": {
      "href": "https://api.lightboxre.com/v1/property-contacts/contact/120376FAJ8XHRJBVGCALN8"
    }
  },
  "_metadata": {
    "geogcs": {
      "epsg": "4362"
    },
    "recordSet": {
      "totalRecords": 1,
      "bbox": {
        "xMax": -105.250409,
        "xMin": -105.251916,
        "yMax": 40.023629,
        "yMin": 40.022576
      }
    },
    "geocode": {
      "confidence": {
        "streetNumber": 0.98,
        "streetName": 1,
        "locality": 0.99,
        "postalCode": 1,
        "score": 0.99
      },
      "precisionCode": 10
    }
  },
  "data": [
    {
      "_ids": {
        "self": null,
        "assessment": "03019ZZRP1MR0TST3RQC36",
        "parcel": "0205PZNY99O607GJU9JRFT"
       },
      "_links": {
        "self": {
          "href": "https://api.lightboxre.com/v1/property-contacts/contact/120376FAJ8XHRJBVGCALN8"
        },
        "assessment": {
          "href": "https://api.lightboxre.com/v1/assessments/us/03019ZZRP1MR0TST3RQC36"
        },
        "parcel": {
          "href": "https://api.lightboxre.com/v1/parcels/us/0205PZNY99O607GJU9JRFT"
        }
      },
      "assessment": {
        "location": {
          "streetAddress": "23143 CHERRY AVE",
          "locality": "LAKE FOREST",
          "regionCode": "CA",
          "postalCode": "92630",
          "postalCodeExt": "4537",
          "countryCode": "US",
          "representativePoint": {
            "longitude": -117.687713,
            "latitude": 33.627483,
            "geometry": {
              "wkt": "POINT(-117.687713 33.627483)"
            }
          },
          "geometry": {
            "wkt": "POINT(-117.687713 33.627483)"
          }
        }
      },
      "source": "LIGHTBOX",
      "contacts": [
        {
          "id": "120376FAJ8XHRJBVGCALN8",
          "confidence": 1,
          "titles": [
            "REGISTERED AGENT"
          ],
          "firstName": "RICHARD",
          "middleName": "F",
          "lastName": "CODY",
          "nameSuffix": "JR",
          "deceased": false,
          "address": {
            "streetAddress": "23143 CHERRY AVE",
            "locality": "LAKE FOREST",
            "regionCode": "CA",
            "postalCode": "92630",
            "postalCodeExt": "4537",
            "countryCode": "US"
          },
          "emails": [
            "john-doe@yahoo.com"
          ],
          "phones": [
            {
              "number": "4258618500",
              "type": "L",
              "firstSeen": "2023-02-15T00:00:00.000Z",
              "lastSeen": "2023-02-15T00:00:00.000Z"
            }
          ],
          "businessEntity": {
            "name": "OROMO CULTURAL CENTER",
            "emails": [
              "john-doe@yahoo.com"
            ],
            "address": {
              "streetAddress": "23143 CHERRY AVE",
              "locality": "LAKE FOREST",
              "regionCode": "CA",
              "postalCode": "92630",
              "postalCodeExt": "4537",
              "countryCode": "US"
            },
            "phone": {
              "number": "4258618500",
              "type": "L",
              "firstSeen": "2023-02-15T00:00:00.000Z",
              "lastSeen": "2023-02-15T00:00:00.000Z"
            },
            "corporateStatus": [
              "ACTIVE"
            ]
          },
          "relatedBusinessEntity": "string"
        }
      ]
    }
  ]
}

Field Dictionary

HTTP Error Codes

• Property Contacts Overview
• Property Contacts Release Notes