Introduction

Welcome to the BoxLock Control API! You can use our API to access information about your organization, manage locations, locks, barcodes, trackables, access activity logs and a variety of other things.

All of our endpoint examples are written in Shell using curl, which should allow them to be easily generalizable to any programming language you're using to integrate BoxLock into your application.

BoxLock uses API keys to allow access to the API.

Authentication

BoxLock uses API Key to allow access to the API. The API Info for your account is available under Account → Integrations in BoxLock Control. If you need additional API Keys generated or the API Key is not populated, please reach out to your BoxLock Customer Success Representative.

The BoxLock Control API expects the API Key to be included in all API requests to the server. Authorization as the header key and Bearer {yourApiKey} as the value.

List Filtering

You can filter most of our data objects by their field properties (ie locks, barcodes, and trackables).

• Supported Operators - eq, gt, gte, lt, lte, ne, between, notBetween, in, notIn, overlap, contains, contained, like
• Paging - limit,offset
• Sorting - sort (sort=updatedAt or sort=-updatedAt)
• the different filtering options are added to a JSON object, and then that object must be URL encoded
• JSON format for the request is ?filter={"id":"eq:12345"} (for example). You can filter on any field that an object has attributed to it (e.x. filtering by lockId on lockActivities)

Example Requests

GET https://apis.getboxlock.com/v3/lockActivities/?filter=%7B%22id%22%3A%22eq%3A12345%22%7D

API Reference

Users

A user represents a BoxLock Control organization user.

Methods

• info - returns info about a BoxLock Control User
• list - returns a list of BoxLock Control users
• insert - create a new user record
• update - update a user record
• delete - delete a user record

Properties

• id - unique identifier
• name - the users full name
• email - the users email address
• locationId - the id of the location the user is assigned to
• group - the group/role assigned to the user

GET /users/{id}

This endpoint retrieves an individual user.

Example Request

curl -X GET https://apis.getboxlock.com/v3/users{id}
-H “Authorization": Bearer <ApiKey>”

The above command returns JSON structured like this:

{
	"id": "int",
	"name": "string",
	"email": "string",
	"locationId": "int",
	"group": "string",
	"createdAt": "date",
	"updatedAt": "date"

}

GET /users/

This endpoint retrieves a list of users for the currently requesting organization.

Example Request

curl -X GET https://apis.getboxlock.com/v3/users
-H "Authorization": "Bearer <ApiKey>"

The above command returns JSON structured like this:

{
	"data": [{
		"id": "int",
		"name": "string",
		"email": "string",
		"locationId": "int",
		"group": "string",
		"createdAt": "date",
		"updatedAt": "date"
	}]
}

POST /users/

This endpoint creates a user for the currently requesting organization.

Properties

• name - first name and last name of the user
• email - email address for the user
• locationId - the location assigned to the user. not required. (Only used for users create in the LocationAdmin group)
• group
• OrganizationAdmin - Can write, delete, update an object for assigned Org.
• OrganizationManager - Same as OrganizationAdmin but can’t create users.
• OrganizationAnalyst - Can read an object for Org.
• LocationAdmin - Can write, delete, update an object for assigned location.

Example Request

curl -X GET https://apis.getboxlock.com/v3/users
-H "Authorization": "Bearer <ApiKey>"
-d {"name":"John Smith","email":"john.smith@getboxlock.com","locationId":3,"group":"LocationAdmin"}

The above command returns JSON structured like this:

{
		"id": "int",
		"name": "string",
		"email": "string",
		"locationId": "int",
		"group": "string",
		"createdAt": "date",
		"updatedAt": "date"
}

PUT /users/{id}

This endpoint updates a user for the currently requesting organization.

Properties

• name - first name and last name of the user
• email - email address for the user
• locationId - the location assigned to the user. not required. (Only used for users create in the LocationAdmin group)
• group
• OrganizationAdmin - Can write, delete, update an object for assigned Org.
• OrganizationManager - Same as OrganizationAdmin but can’t create users.
• OrganizationAnalyst - Can read an object for Org.
• LocationAdmin - Can write, delete, update an object for assigned location.

Example Request

curl -X PUT https://apis.getboxlock.com/v3/users
-H "Authorization": "Bearer <ApiKey>"
-d {"name":"John Smith"}

The above command returns JSON structured like this:

{
		"id": "int",
		"name": "string",
		"email": "string",
		"locationId": "int",
		"group": "string",
		"createdAt": "date",
		"updatedAt": "date"
}

DELETE /users/{id}

This endpoint deletes a user for the currently requesting organization.

Properties

• id - unique identifier

Example Request

curl -X DELETE https://apis.getboxlock.com/v3/users/{id}
-H "Authorization": "Bearer <ApiKey>"

The above command returns JSON structured like this:

if successful, this request returns a 204 (No content)

Locks

A lock represents the currently requesting organization’s lock.

Methods

• info - returns info about a Lock
• list - list of Locks

Properties

• id - unique identifier
• userId - id for the lock owner
• locationId - the location the lock is assigned to
• name - default name for a lock
• niceName - user friendly name for a lock
• lockOpen - lock state 0=closed, 1=open, 2=unknown
• batteryLevel - lock battery level 0-100
• batteryCharging - the charging state of the lock
• disconnectedAt - timestamp when the lock disconnected

GET /locks/{id}

This endpoint retrieves a lock for the currently requesting organization.

Properties

• id - unique identifier

Example Request

curl -X GET https://apis.getboxlock.com/v3/locks/{id}
-H "Authorization": "Bearer <ApiKey>"

The above command returns JSON structured like this:

{
		"id": "int",
		"name": "string",
		"locationId": "int",
		"niceName": "string",
		"lockOpen": "enum",
		"batteryLevel": "int",
		"batteryCharging": "int",
    "disconnectedAt": "date",
		"createdAt": "date",
		"updatedAt": "date"
}

GET /locks

This endpoint retrieves a list of locks for the currently requesting organization.

Example Request

curl -X GET https://apis.getboxlock.com/v3/locks
-H "Authorization": "Bearer <ApiKey>"

The above command returns JSON structured like this:

{
	"items": [{
		"id": "int",
		"name": "string",
		"locationId": "int",
		"niceName": "string",
		"lockOpen": "enum",
		"batteryLevel": "int",
		"batteryCharging": "int",
		"disconnectedAt": "date",
		"createdAt": "date",
		"updatedAt": "date"
	}],
	"page": "int",
	"total": "int"
}

Lock Activities

An lock activity represents a log of lock events.

Methods

• info - returns info about a lock activity
• list - returns a list of lock activities

Properties

• id - unique identifier
• activityType - unique activity code (see below for activity code descriptions)
• userId - id for the lock owner
• organizationId - the organization that owns the lock
• locationId - the location associated with the activity
• barcodeId - the barcode associated with the activity
• lockId - the lock associated with the activity
• title - activity title
• details - Additional details about the activity
• modeMmc - Mobile-to mobile convergence when the activity happened
• modeLac - Mobile Network Code when the activity happened
• modeLac - Location Area Code when the activity happened
• modeCid - Base transceiver station identifier
• lat - latitude value when the activity happened
• lng - longitude value when the activity happened

GET /locks/activities/{activityId}

This endpoint retrieves a lock activity for the currently requesting organization.

Property

• id - lock unique identifier
• activityId - lock activity unique identifier

Example Request

curl -X GET https://apis.getboxlock.com/v3/locks/activities/{id}
-H "Authorization": "Bearer <ApiKey>"

The above command returns JSON structured like this:

{

	"id": "int",
	"activityType": "int",
	"userId": "int",
	"organizationId": "int",
	"locationId": "int",
	"barcodeId": "int",
	"title": "string",
	"modeMmc": "int",
	"modeMnc": "int",
	"modeLac": "int",
	"modeCid": "int",
	"lat": "float",
	"lng": "float",
	"createdAt": "date",
	"updatedAt": "date"

}

GET /locks/activities

This endpoint retrieves a list of lock activities for the currently requesting organization.

Example Request

curl -X GET https://apis.getboxlock.com/v3/locks/activities/{id}
-H "Authorization": "Bearer <ApiKey>"

Lock Activity Codes & Descriptions

1. Package Delivery
2. User Barcode Scan
3. Unlock over Bluetooth
4. Master Barcode Scan
5. User Added to Account
6. Battery Issue
7. Wifi Issue
8. Lock Issue (Left open, etc)
9. Unrecognized Package/Barcode Scanned
10. Own Package Scanned When Not "Out for Delivery"
11. Own Package Scanned When Already Delivered
12. Expired Barcode Scanned
13. Unauthorized Unlock Attempt
14. Lock Closed
15. Expired Press Unlock Access
16. Successful Press Unlock
17. Status Update
18. Parsyl Update
19. Lock Already Connected
20. Lock Added
21. Intrusion Attempt Detected
22. Signature Release
23. GPS Update
24. QuantumView Package
25. UPP Smart Pickup

Lock Access Actions

A lockAccess represents an action that can be taken on a Lock. Currently the only action that is allowed is “Push to Unlock”.

Methods

• insert - returns info about a BoxLock Control user.

Properties

• id - unique identifier
• lockId - locks unique identifier
• accessType - always 0
• duration - access duration in seconds
• accessor - always 1
• details - additional information about the request that will log into the general activity description.

POST /access/locks

This endpoint creates a lockAccess record for the currently requesting organization target lock. (“Push To Open”)

Properties

• lockID - target lock to allow access
• accessType - type of access needed (0 is “Push to Unlock”)
• accessor - the type of accessor (should be 1)
• duration - how long the auction in valid for
• details - general activity details

Example Request

curl -X POST https://apis.getboxlock.com/v3/access/locks
-H "Authorization": "Bearer <ApiKey>"
-d {"lockId": 1111,"accessType":0,"accessor":1,"duration":30}

The above command returns JSON structured like this:

{
	"id": "int",
	"lockId": "int",
	"duration": "int",
	"accessType": "int",
	"Accessor": "int",
	"createdAt": "date",
	"updatedAt": "date"
}

Lock Configurations

A lockConfig represents a configuration belonging to the currently requesting organization.

Methods

• info - returns info about an organizations current lockConfig
• update - update a lockConfig

Properties

• connectionTime - TODO
• connectedWhenOpen - TODO
• intrusionForce - TODO
• intrusionWakeDuration - TODO
• intrusionSleepDuration - TODO
• parsylSupport - TODO
• lightningCodesEnabled - TODO
• lightningCodesExpiration - TODO
• gpsSupport - TODO
• pressToUnlockTime - TODO
• sensorCicList - TODO

GET /v3/configure/locks/organization

This endpoint gets the lockConfig record for the currently requesting organization.

Example Request

curl -X GET https://apis.getboxlock.com/v3/configure/locks/organization
-H "Authorization": "Bearer <ApiKey>"

The above command returns JSON structured like this:

{
	"connectionTime": "int",
  "connectedWhenOpen": "int",
  "intrusionForce": "int",
  "intrusionWakeDuration": "int",
  "intrusionSleepDuration": "int",
  "parsylSupport": "boolean",
  "lightningCodesEnabled": "boolean",
  "lightningCodesExpiration": "int",
  "gpsSupport": "boolean",
  "pressToUnlockTime": "int",
  "sensorCicList": "string",
}

PUT /v3/configure/locks/organization

This endpoint updates the lockConfig record for the currently requesting organization.

Example Request

curl -X PUT https://apis.getboxlock.com/v3/access/locks
-H "Authorization": "Bearer <ApiKey>"
-d {"connectionTime": 600,"sensorCicList": "AAAAA,BBBB,DDDD,EEEE"}

The above command returns JSON structured like this:

{
	"connectionTime": "int",
  "connectedWhenOpen": "int",
  "intrusionForce": "int",
  "intrusionWakeDuration": "int",
  "intrusionSleepDuration": "int",
  "parsylSupport": "boolean",
  "lightningCodesEnabled": "boolean",
  "lightningCodesExpiration": "int",
  "gpsSupport": "boolean",
  "pressToUnlockTime": "int",
  "sensorCicList": "string",
}

Sensors

A sensor represents an third-party IoT sensor.

Methods

• info - returns info about a sensor
• list - list of sensors

Properties

• id - unique identifier
• deviceId - device id for iot sensor
• locationId - the location the lock is assigned to
• niceName - user friendly name for a lock
• cic - the Company Identifier Code that represents the company the sensor belongs to
• rssi - the signal strength of the sensor

GET /sensors/{id}

This endpoint retrieves a sensor for the currently requesting organization.

Properties

• id - unique identifier

Example Request

curl -X GET https://apis.getboxlock.com/v3/sensors/{id}
-H "Authorization": "Bearer <ApiKey>"

The above command returns JSON structured like this:

{
		"id": "int",
		"deviceId": "string",
		"niceName": "string",
		"company": "string",
		"cic": "string",
		"rssi": "string",
		"locationId": "int",
		"organizationId": "int",
		"createdAt": "date",
		"updatedAt": "date"
}

GET /sensors

This endpoint retrieves a list of sensors for the currently requesting organization.

Example Request

curl -X GET https://apis.getboxlock.com/v3/sensors
-H "Authorization": "Bearer <ApiKey>"

The above command returns JSON structured like this:

{
	"items": [{
		"id": "int",
		"deviceId": "string",
		"niceName": "string",
		"company": "string",
		"cic": "string",
		"rssi": "string",
		"locationId": "int",
		"organizationId": "int",
		"createdAt": "date",
		"updatedAt": "date"
		"updatedAt": "date"
	}],
	"page": "int",
	"total": "int"
}

Sensor Activities

A sensor activity represents a logging of third-party IoT sensor events.

Methods

• info - returns info about a sensor activity
• list - returns a list of sensor activities

Properties

• id - unique identifier
• deviceId - the device id of the IoT sensor
• lockId - the id of the lock associated with the event
• lock - the lock associated with the event
• sensorId - the id of the sensor associated with the vent
• sensor - the sensor associated with the event
• organization - the organization associated with the event
• location - the location associated with the event

GET /sensors/activities/{activityId}

This endpoint retrieves a sensor activity for the currently requesting organization.

Property

• id - sensor unique identifier
• activityId - sensors activity unique identifier

Example Request

curl -X GET https://apis.getboxlock.com/v3/sensors/activities/{id}
-H "Authorization": "Bearer <ApiKey>"

The above command returns JSON structured like this:

{
	"id": "int",
	"lockId": "int",
	"deviceId": "622464f1",
	"sensor": Sensor,
	"sensorId": "int",
	"lock": Lock,
	"organization": Organization,
	"location": location,
	"createdAt": "date",
	"updatedAt": "date"

}

GET /sensors/activities

This endpoint retrieves a list of sensor activities for the currently requesting organization.

Properties

• id - sensor unique identifier

Example Request

curl -X GET https://apis.getboxlock.com/v3/sensors/activities/{id}
-H "Authorization": "Bearer <ApiKey>"

General Activities

A general activity represents a log of standard and custom events for an organization.

Methods

• info - returns info about a general activity
• list - returns a list of general activities

Properties

• id - unique identifier
• generalActivityType - the type of general activity
• application - the application that triggered the event
• applicationVersion - the application version that triggered the event
• details - a general description of the event
• metadata - custom event base info (more technical data)
• location - location associated with the event
• user - the user that triggered the event (if there is no user, then it’s a system event)

GET /general/activities/{activityId}

This endpoint retrieves a general activity for the currently requesting organization.

Property

• id - activity unique identifier
• activityId - activity unique identifier

Example Request

curl -X GET https://apis.getboxlock.com/v3/general/activities/{id}
-H "Authorization": "Bearer <ApiKey>"

The above command returns JSON structured like this:

{
	"id": "int",
	"generalActivityType": "enum",
	"application": "string",
	"applicationVersion": "string",
	"details": "string",
	"metadata": "object",
	"location": Location,
	"user": User,
	"createdAt": "date",
	"updatedAt": "date"

}

GET /general/activities

This endpoint retrieves a list of general activities for the currently requesting organization.

Example Request

curl -X GET https://apis.getboxlock.com/v3/general/activities
-H "Authorization": "Bearer <ApiKey>"

The above command returns JSON structured like this:

{
	"items": [{
		"id": "int",
		"generalActivityType": "enum",
		"application": "string",
		"applicationVersion": "string",
		"details": "string",
		"metadata": "object",
		"location": Location,
		"user": User,
		"createdAt": "date",
		"updatedAt": "date"
	}],
	"page": "int",
	"total": "int"
}

Trackables

A trackable represents any item belonging to the currently requesting organization that can be tracked.

Methods

• info - returns info about a trackable
• insert - create one or more trackables
• update - update a trackable
• delete - delete a trackable

Properties

• id - unique identifier
• name - nice name for the trackable
• type - trackable type code (see reference below for trackable types)
• carrierName - name for the carrier
• trackingNumber - tracking identifier provided by the shipper
• status - the state of a trackable (ex: “Out for Delivery”, “In Transit", or "Delivered")
• description - a description for the trackable.
• userId - id for the trackable owner
• details- any extra details associated with the specific trackable
• url - the tracking url provided by the carrier
• shipperName - name for the shipper
• deliveredAt - the timestamp for a delivered trackable
• locationId - the location the trackable is assigned to
• externalId- the external id for a trackable
• shipmentNumber - the shipment number for a trackable
• metadata - metadata associated with a trackable
• location - info about the location associated with a trackable

Trackable Type Codes & Descriptions

0. Default
1. Parcel
2. Tool
3. Part
4. Vote
5. Consumable
6. Kit
7. Material
8. Specimen
9. Other
10. LOTO

GET /trackables/{id}

This endpoint retrieves a trackable for the currently requesting organization.

Request Parameters

• id - unique identifier
• trackingNumber - tracking number can be used in place of the {id}

Example Request

curl -X GET https://apis.getboxlock.com/v3/trackables/1234
-H "Authorization": "Bearer <ApiKey>"

The above command returns JSON structured like this:

{
	"id": "string",
	"name": "string",
	"type": int,
	"carrierName": "string",
	"trackingNumber": "string",
	"status": "string",
	"description": "string",
	"userId": "string",
	"details": {json},
	"url": "string",
	"shipperName": "string",
	"deliveredAt": date,
	"organizationId": "string",
	"locationId": "string",
	"externalId": "string",
	"shipmentNumber": "string",
	"metadata" : {json},
	"createdAt": date,
	"updatedAt": date,
	"location": Location
}

POST /trackables

This endpoint creates a trackable for the currently requesting organization.

Request Parameters

• trackingNumber - tracking identifier provided by the shipper
• locationId - the assigned location for the trackable
• carrierName - name for the carrier
• shipperName - name for the shipper
• url - the tracking url provided by the carrier
• description - a description for the trackable.
• status - can be “out_for_delivery”, “in_transit", or "delivered"
• type - can be any trackable type

Example Request

curl -X POST https://apis.getboxlock.com/v3/trackables
-H "Authorization": "Bearer <ApiKey>"
-d {"trackingNumber":"374DJNWLKEID","carrierName":"Carrier Name","shipperName":"Shipper Name","url":"https://apis.getboxlock.com/v2/control/trackables","description":"My trackable","status":"out_for_delivery","type":2}

The above command returns JSON structured like this:

{
	"id": int,
	"userId": int,
	"locationID": int,
	"trackingNumber": int,
	"carrierName": "string",
	"shipperName": "string",
	"url": "string",
	"description": "string",
	"status": "string"
	"deliveredAt": date,
	"createdAt": date,
	"updatedAt": date
}

PUT /trackables/{id}

This endpoint updates a trackable for the currently requesting organization.

Request Body

Parameters

• url - the tracking url provided by the carrier
• description - a description for the trackable.
• status - can be “out_for_delivery”, “in_transit", or "delivered"

Example Request

curl -X PUT https://apis.getboxlock.com/v3/trackables/1234
-H "Authorization": "Bearer <ApiKey>"
-d {"url":"http://track.getboxlock.com/barcodes/barcodeVis.php?barcode=D8DJSKKDIE","description":"My trackable","status":"out_for_delivery"}

The above command returns JSON structured like this:

{
	"id": int,
	"userId": int,
	"locationID": int,
	"trackingNumber": int,
	"carrierName": "string",
	"shipperName": "string",
	"url": "string",
	"description": "string",
	"status": "string"
	"deliveredAt": date,
	"createdAt": date,
	"updatedAt": date
}

DELETE /trackables/{id}

This endpoint deletes a trackable for the currently requesting organization.

Request Body

Parameters

• id - unique identifier
• trackingNumber - tracking number can be used in place of the {id}

Example Request

curl -X DELETE https://apis.getboxlock.com/v3/trackables/1234
-H "Authorization": "Bearer <ApiKey>"

The above command returns JSON structured like this:

If successful, this request returns a 204 (No Content)

Locations

A location represents a place within an organizations hierarchy.

Methods

• info - returns info about a location
• list - list of locations
• insert - create one or more locations
• update - update a location
• delete - delete a location

Properties

• id - unique identifier
• organizationId - identifier for the location's organization owner
• locationType - location type (default = 0 AND group = 1)
• address1 - street address for the location
• address2 - additional address information (ex. Suite, Apt, Unit)
• state - the state for the location
• city - the city for the location
• zip - the zip/postal code for the location
• country - the country for the location
• contactName - the name of the primary contact for the location
• contactPhoneNumber - the name of the primary contact for the location
• status - Indicates whether the location is active
• groupItems - the locations associated with a location of type group.

GET /locations/{id}

This endpoint retrieves a location for the currently requesting organization

Example Request

curl -X GET https://apis.getboxlock.com/v3/locations/1234
-H "Authorization": "Bearer <ApiKey>"

Example Response

{
	"id": "int",
	"organizationId": "int",
	"locationType": "enum",
		"address1": "string",
		"address2": "string",
		"state": "string",
		"city": "string",
		"zip": "string",
		"country": "string",
		"contactName": "string",
		"contactPhoneNumber": "string",
		"status": "int",
		"groupItems": [{
			"id": "int",
			"parentid": "int",
			"parent": Location,
			"collectionSourceId": "int",
			"collectionSourceType": "string",
			"source": Location,
			"organizationId": "int",
			"organization": Organization,
		}],
	"createdAt": "date",
	"updatedAt": "date"

}

GET /locations

This endpoint retrieves a locations for the currently requesting organization.

Example Request

curl -X GET https://apis.getboxlock.com/v3/locations
-H "Authorization": "Bearer <ApiKey>"

Example Response

{
	"items": [{
		"id": "int",
		"organizationId": "int",
		"locationType": "enum",
		"address1": "string",
		"address2": "string",
		"state": "string",
		"city": "string",
		"zip": "string",
		"country": "string",
		"contactName": "string",
		"contactPhoneNumber": "string",
		"status": "int",
		"groupItems": [{
			"id": "int",
			"parentid": "int",
			"parent": Location,
			"collectionSourceId": "int",
			"collectionSourceType": "string",
			"source": Location,
			"organizationId": "int",
			"organization": Organization,
		}],
	}],
	"page": "int",
	"total": "int"
}

POST /locations

This endpoint creates a location for the currently requesting organization.

Request Body

Parameters

• address1 - tracking identifier provided by the shipper
• address2 - additional address information (ex. Suite, apt)
• state - the state of the location
• city - the tracking url provided by the carrier
• zip - the zip/postal code for the location
• country - the country for the location
• contactName - primary contacts name
• contactPhoneNumber - primary contact phone number (format ex. +17708515123)
• status - can be 0 (inactive) or 1 (active)

Example Request

curl -X POST https://apis.getboxlock.com/v3/locations/1234
-H "Authorization": "Bearer <ApiKey>"
-d {"address1":"124 Fairlane Way","address2":"Suite 127”,”state":"GA","city":"Atlanta","zip":"30309","country":"USA", "contactName": "John Doe", "contactPhoneNumber": "+17708515123"}

The above command returns JSON structured like this:

{
	"id": "int",
	"locationType": "enum",
	"organizationId": "int",
	"address1": "string",
	"address2": "string",
	"state": "string",
	"city": "string",
	"zip": "string",
	"country": "string",
	"contactName": "string",
	"contactPhoneNumber": "string",
	"status": "int",
	"createdAt": "date",
	"updatedAt": "date"

}

PUT /locations/{id}

This endpoint updates a location for the currently requesting organization.

Request Body

Parameters

• address1 - tracking identifier provided by the shipper
• address2 - additional address information (ex. Suite, apt)
• state - the state of the location
• city - the tracking url provided by the carrier
• zip - the zip/postal code for the location
• country - the country for the location
• contactName - primary contacts name
• contactPhoneNumber - primary contact phone number (format ex. +17708515123)
• status - can be 0 (inactive) or 1 (active)

Example Request

curl -X PUT https://apis.getboxlock.com/location/v2/control/locations/1234
-H "Authorization": "Bearer <ApiKey>"
-d {"address1":"124 Fairlane Way"}

The above command returns JSON structured like this:

{
	"id": "int",
	"locationType": "enum",
	"organizationId": "int",
	"address1": "string",
	"address2": "string",
	"state": "string",
	"city": "string",
	"zip": "string",
	"country": "string",
	"contactName": "string",
	"contactPhoneNumber": "string",
	"status": "int",
	"createdAt": "date",
	"updatedAt": "date"
}

DELETE /locations/{id}

This endpoint deletes a location for the currently authenticated organization.

Request Body

Parameters

• id - unique identifier

Example Request

curl -X DELETE https://apis.getboxlock.com/v3/locations/1234
-H "Authorization": "Bearer <ApiKey>"

The above command returns JSON structured like this:

If successful, this request returns a 204 (No Content)

Barcodes

A barcode represents a code used for access control of a BoxLock user’s lock.

Methods

• info - returns info about a location
• list - list of locations
• insert - create a barcode for lock access
• update - update a barcode
• delete - delete a barcode

Properties

• id - unique identifier
• userID - identifier for the lock owner
• lockID - the lock to assign the barcode to (can be null)
• locationID - the location to assign the barcode to (can be null)
• barcode - barcode to be created
• accessType - set to 1=unlimited use barcode, 2=time-based barcode, 3=use-based barcode
• enabled - the active status
• enabledFrom - applicable only for access_type 2, this is the date the barcode starts to be valid (YYYY-MM-DD)
• enabledTo - applicable only for access_type 2, this is the date the barcode is no longer valid (YYYY-MM-DD)
• useLimit -
• uses - applicable only for access_type 3. This is the number of uses the barcode is valid for.
• offline - makes a barcode a lightening code (offline barcode)

GET /barcodes/{id}

This endpoint retrieves info about a barcode the currently authenticated organization has attached to their lock.

Request Parameters

• id - unique identifier
• barcode - barcode can be used in place of the {id}

Example Request

curl -X GET https://apis.getboxlock.com/v3/barcodes/4DKDIE8
-H "Authorization": "Bearer <ApiKey>"

The above command returns JSON structured like this:

{
	"id": "int",
	"userId": "int",
	"lockId": "int",
	"locationId": "int",
	"barcode": "string",
	"accessType": "enum",
	"enabled": "boolean",
	"enabledFrom": "date",
	"enabledTo": "date",
	"useLimit": "int",
	"uses": "int",
	"offline": "boolean",
	"createdAt": "date",
	"updatedAt": "date"

}

GET /barcodes

This endpoint retrieves a list of barcodes the currently authenticated organization has attached to their lock.

Example Request

curl -X GET https://apis.getboxlock.com/v3/barcodes
-H "Authorization": "Bearer <ApiKey>"

The above command returns JSON structured like this:

{
	"items": [{
		"id": "int",
		"userId": "int",
		"lockId": "int",
		"locationId": "int",
		"barcode": "string",
		"accessType": "enum",
		"enabled": "boolean",
		"enabledFrom": "date",
		"enabledTo": "date",
		"useLimit": "int",
		"uses": "int",
		"offline": "boolean",
		"createdAt": "date",
		"updatedAt": "date"

	}],
	"page": "int",
	"total": "int"
}

POST /barcodes

This endpoint creates a barcode for the currently authenticated organization has attached to their lock.

Request Body

Parameters

• barcode - barcode to be created
• accessType - set to 1=unlimited use barcode, 2=time-based barcode, 3=use-based barcode.
• lockId - the lock to assign the barcode to (can be null)
• locationId - the location to assign the barcode to (can be null)
• uses - applicable only for access_type 3. This is the number of uses the barcode is valid for.
• enabledFrom - applicable only for access_type 2, this is the date the barcode starts to be valid (YYYY-MM-DD)
• enabledTo - applicable only for access_type 2, this is the date the barcode is no longer valid (YYYY-MM-DD)
• offline - TODO

Example Request

curl -X POST https://apis.getboxlock.com/barcode/v2/control/barcodes
-H "Authorization": "Bearer <ApiKey>"
-d {"barcode": "DKEIE736", "accessType": 1}

The above command returns JSON structured like this:

{
	"id": "int",
	"userId": "int",
	"lockId": "int",
	"locationId": "int",
	"barcode": "string",
	"accessType": "enum",
	"enabled": "boolean",
	"enabledFrom": "date",
	"enabledTo": "date",
	"useLimit": "int",
	"uses": int,
	"offline": "boolean",
	"createdAt": "date",
	"updatedAt": "date"

}

PUT /barcodes

This endpoint updates a barcode for the currently authenticated organization.

Request Body

Parameters

• barcode - barcode to be U
• accessType - set to 1=unlimited use barcode, 2=time-based barcode, 3=use-based barcode.
• lockId - the lock to assigned the barcode to (can be null)
• locationId - the location to assigned the barcode to (can be null)
• uses - applicable only for access_type 3. This is the number of uses the barcode is valid for.
• enabledFrom - applicable only for access_type 2, this is the date the barcode starts to be valid (YYYY-MM-DD)
• enabledTo - applicable only for access_type 2, this is the date the barcode is no longer valid (YYYY-MM-DD)
• offline - TODO

Example Request

curl -X PUT https://apis.getboxlock.com/barcode/v2/control/barcodes
-H "Authorization": "Bearer <ApiKey>"
-d {"barcode": "DKEIE736", "accessType": 1}

The above command returns JSON structured like this:

{
	"id": "int",
	"userId": "int",
	"lockId": "int",
	"locationId": "int",
	"barcode": "string",
	"accessType": "enum",
	"enabled": "boolean",
	"enabledFrom": "date",
	"enabledTo": "date",
	"useLimit": "int",
	"uses": "int",
	"createdAt": "date",
	"updatedAt": "date"

}

DELETE /barcodes/{id}

This endpoint delete a barcode the currently authenticated organization has attached to their lock.

Request Body

Parameters

• id - unique identifier
• barcodes - barcode can be used in place of the {id}

Example Request

curl -X DELETE https://apis.getboxlock.com/v3/barcodes/4DKDIE8
-H "Authorization": "Bearer <ApiKey>"

The above command returns JSON structured like this:

If successful, this request returns a 204 (No Content)