Lockbox System Import Specification

Import Method

Our import methods are flexible and we will work with you to find one that is mutually agreeable. We can provide you, or your vendor, with API access, or we can retrieve the files from your system nightly via RETS, HTTP, or SFTP.

We can also work with various file types. The simplest method is to use a comma delimited text file. Please include a header line denoting field contents as the first line of each file.

Please note, regardless of whether we receive all of the data from one system or multiple systems, the ability to tie the data together is the main requirement. For instance, if you want to send us office/agent data from your Membership system and listings from your MLS system, then there must be a field in both systems that can tie listing to the agent.

To ensure the accuracy and integrity of your data SentriLock may occasionally request a full dataset to conduct software testing. You are responsible for providing this data and for any costs associated with obtaining data from your data vendors.

How to Contact the SentriLock Development Staff

During the conversion process, you may be in contact with several members of the SentriLock Development staff. When you send e-mail or reply to an e-mail message from the SentriLock Development staff, please direct your e-mail to datafeed@sentrilock.com in order to assure all members of the Development staff will see your message. This helps to ensure a smooth conversion.

Company / Office

For each office (or company) in your Association please specify the following information:

  • Unique ID
  • Name
  • Contact Number
    • Area Code
    • Phone Number
  • Street Address
  • City
  • State/Province
  • Zip/Postal Code
  • Country (if other than US)
  • Status


For each person in your Association who will have access to the REALTOR® LOCKBOX system please specify the following:

  • Unique ID
  • NRDS/NAF Number (or your National REALTOR® Identification Number)
  • Real Estate License Number
  • Type (see below)
  • First Name
  • Last Name
  • Home/Office Number
    • Area Code
    • Phone Number
  • Cell/Mobile Number
    • Phone number is required
    • Phone number must use the following format: XXX-XXX-XXXX
  • Email Address
    • Email address is required
    • Each user must have a unique email address
  • Office
    • This must match the Unique ID from the Office file to indicate this user’s primary office
  • User Name
  • Status
  • Key Status

IMPORTANT INFORMATION: SentriLock requires a unique User Name for each user.  If the User Name you provide us is not unique within our system, we will append a value to it.  For example, if you provide us with the User Name “MSmith” and our system already has an “MSmith” User Name, we will add your region code to the User Name.  In this case, the User Name “MSmith” becomes “MSmith-999”.

User Types

The Type field indicates which kind of access this person should receive.  Possible types are:


Administrators have access to all data in the Association. They can also authorize new Agents for a SentriKey® account.


A Broker has access to all agents and listings within the office they are associated with.  They can have listings, own lockboxes, and be issued a SentriKey® account.

Office Staff

Office staff has access to all Agents and listings within the office they are associated with.


An Agent can see their own data.  They can have listings, own lockboxes, and be issued a SentriKey® account.


An Affiliate can be issued a limited access SentriKey® account which does not allow them to own lockboxes.


An Assistant can see their team’s data.  They can be issued a limited access SentriKey® account which only allows them operation of their team member’s lockboxes.

If your User file contains types other than these, please provide us with a text file or e-mail that explains how each type should be processed.  If you have data types 1, 2, 3, and 4, you need to tell us which of these types is an Administrator and which is a Broker.  For example, your e-mail or text file could include something like:

  • 1=Administrator
  • 2=Broker
  • 3=Office Staff
  • 4=Agent


  • MLS Number
  • User ID
    • This must match the Unique ID from the User file to indicate the listing agent
  • Street Address
  • Street Address Line 2
  • City
  • State/Province
  • Zip/Postal Code
  • Country (if other than US)
  • Price
  • Half Baths
  • Full Baths
  • Bedrooms
  • Unique ID that identifies photos
  • Photo Count Field
  • Photo Last Modified Timestamp Field
  • Photo Pull Method (Get Object or Search)
  • Status
  • Latitude
  • Longitude
  • Showing Instructions

User Photos 

We provide a means for uploading an individual’s photo to their profile. If you wish to provide us user photos, then they must be named using the Unique ID from the User data.  For instance, if a user’s Unique ID is ’1234′, then their photo must be named ’1234.jpg’ or ’1234.gif’ etc.  In addition, we HIGHLY recommend that user photos adhere to the following criteria:

  • Medium size anywhere from 200KB to 500KB, ideal hi-res, 150 pixels resolution or higher
  • Portrait format with a width-to-height ratio of .75 (in pixels should be 75/100 or correspondent multiple of each, e.g. 150/200, 300/400, etc.)
  • HEADSHOT ONLY, no body shots.  Also, no team photos, group shots, family members, pets, etc. are allowed
  • Users also have the ability to upload their own photo