API Documentation

Everything you need to interact with AccessGrid via API.

Install our SDK in your preferred language

Authentication

We use a dual authentication mechanism, it consists of two parts:

  1. A static account id to be sent in the X-ACCT-ID header
  2. A shared secret scheme to authenticate every API request with a signed payload in the X-PAYLOAD-SIG header

You can find both keys in your AccessGrid console on the API keys page. If you're logged in, they're automatically embedded into this documentation.

List NFC keys

Retrieve a list of NFC keys for a specific card template. You can optionally filter by current state.

template_id

string

Required. The card template ID to list keys for


state

nullable string

Filter keys by state (active, suspended, unlink, deleted)

Issue NFC key

Enable a pass to be added to be created and installed on their mobile device with the constraints set in the AccessGrid console and this API call. Returns a landing page for installing the access pass.

card_template_id

string

Unique identifier for the card template to use


employee_id

string

Unique identifier for the employee


tag_id

nullable string

Physical tag identifier associated with the NFC key, only allowed if your card template has key diversification enabled


site_code

nullable string

Site code from H10301 (26 bit) format. Must be number under 255


card_number

string

Site code from H10301 (26 bit) format. Must be number under 65,535


file_data

nullable string

Up to 8192 bytes of data. Only used when using your own proprietary data format


full_name

string

Full name of the employee


email

string

Email address of the employee - if you have a SendGrid or Postmark integration, then we will send a text message on your behalf


phone_number

string

Contact phone number for the employee - if you have a Twilio integration, then we will send a text message on your behalf


classification

string

Employment classification (e.g., full_time, contractor)


start_date

string

ISO8601 timestamp when the card becomes active


expiration_date

string

ISO8601 timestamp when the card expires


employee_photo

string

Base64 encoded image of the employee


member_id

nullable string

Only for 'hotel' use case. Loyalty/membership ID of the guest


membership_status

nullable string

Only for 'hotel' use case. Status of the guest's membership


is_pass_ready_to_transact

nullable boolean

Only for 'hotel' use case. Whether the pass is ready to be used for transactions


tile_data

nullable object

Only for 'hotel' use case. Data for the hotel tile display

checkInAvailableWindowStartDateTime

nullable string

ISO8601 timestamp with timezone. Required if isCheckedIn is missing or false


checkInAvailableWindowEndDateTime

nullable string

ISO8601 timestamp with timezone. Required if isCheckedIn is missing or false


checkInURL

nullable string

URL for remote check-in. Only used if isCheckedIn is missing or false


isCheckedIn

nullable boolean

Whether the guest has checked in


numberOfRoomsReserved

nullable integer

Number of rooms reserved. Must match the number of roomNumbers if both are present


roomNumbers

nullable array

Array of room numbers. Must match the number of numberOfRoomsReserved if both are present


reservations

nullable object

Only for 'hotel' use case. Data for the hotel reservation

checkInDateTime

nullable string

ISO8601 timestamp with timezone. Required if isCheckedIn is true


isCheckedIn

nullable boolean

Whether the guest has checked in


numberOfRoomsReserved

nullable integer

Number of rooms reserved. Must match the number of roomNumbers if both are present


propertyLocation

nullable string

Location of the property (e.g., 'Key West')


propertyName

nullable string

Name of the property (e.g., 'Hyatt Centric Resort & Spa')


propertyMapUrl

nullable string

URL to a map of the property


propertyCategory

nullable string

Category of the property. If provided, must be 'travel'


restaurantVoucher

nullable string

Optional voucher for restaurant services


reservationEndDateTime

nullable string

ISO8601 timestamp with timezone for reservation end


reservationNumber

nullable string

Confirmation number for the reservation


reservationStartDateTime

nullable string

ISO8601 timestamp with timezone for reservation start


roomNumbers

nullable array

Array of room numbers. Must match the number of numberOfRoomsReserved if both are present

Update NFC key

When you need to make an informational update to an NFC key such as name, photo, etc

card_id

string

Unique identifier of the NFC key to update, sent as part of the URL


employee_id

nullable string

Updated unique identifier for the employee


full_name

nullable string

Updated full name of the employee


classification

nullable string

Updated employment classification (e.g., full_time, contractor)


expiration_date

nullable string

Updated ISO8601 timestamp when the card expires


employee_photo

nullable string

Updated base64 encoded image of the employee

Suspend NFC key

When you need to temporarily disable an NFC key for a short period of time

card_id

string

Unique identifier of the NFC key to suspend, sent as part of the URL

Resume NFC key

If you have previously suspended an NFC key, you can re-enable it with the resume action

card_id

string

Unique identifier of the NFC key to resume, sent as part of the URL

Unlink NFC key

If you'd like to force the removal of an NFC key from it's current holder

card_id

string

Unique identifier of the NFC key to unlink from its current holder, sent as part of the URL

Create Card Template Enterprise only

Contact Us

Only available for enterprise customers - allows you to create an empty card template using our console API.

name

string

The name to display for this card template in the AccessGrid console UI


platform

string

Must be one of `apple` or `google`


use_case

string

Must be `employee_badge`


protocol

string

Must be `desfire` or `seos` - HID Seos only available for enterprise customers


allow_on_multiple_devices

nullable boolean

False by default. Set to true if you'd like to enable the NFC keys issued using this template to exist on multiple devices (think phone and watch)


watch_count

nullable integer

Only allowed to be set if `allow_on_multiple_devices` is set to true. Any number between 1-5 is acceptable.


iphone_count

nullable integer

Only allowed to be set if `allow_on_multiple_devices` is set to true. Any number between 1-5 is acceptable.


design

nullable object

Object representing card template design

background_color

nullable string

Must be a 6 character hexadecimal value for the background color of the template, in the event that there is no background_image provided, i.e. #FFFFFF


label_color

nullable string

Must be a 6 character hexadecimal value for the label color for the template, i.e. #000000


label_secondary_color

nullable string

Must be a 6 character hexadecimal value for the secondary label color for the template, i.e. #333333


background_image

nullable string

Base64 encoded image of the card templates background


logo_image

nullable string

Base64 encoded image of the card templates logo (located in the top left)


icon_image

nullable string

Base64 encoded image of the card templates icon (used in sharing and notifications)


support_info

nullable object

Information for users that shows up on the back of the NFC key

support_url

nullable string

Shows on the back of the issued NFC key.


support_phone_number

nullable string

Shows on the back of the issued NFC key.


support_email

nullable string

Shows on the back of the issued NFC key.


privacy_policy_url

nullable string

Shows on the back of the issued NFC key.


terms_and_conditions_url

nullable string

Shows on the back of the issued NFC key.

Update Card Template Enterprise only

Contact Us

Only available for enterprise customers - allows you to update certain attributes of an existing card template using our console API.

card_template_id

string

The card template id you want to update


name

string

The name to display for this card template in the AccessGrid console UI


allow_on_multiple_devices

nullable boolean

False by default. Set to true if you'd like to enable the NFC keys issued using this template to exist on multiple devices (think phone and watch)


watch_count

nullable integer

Only allowed to be set if `allow_on_multiple_devices` is set to true. Any number between 1-5 is acceptable.


iphone_count

nullable integer

Only allowed to be set if `allow_on_multiple_devices` is set to true. Any number between 1-5 is acceptable.


support_info

nullable object

Information for users that shows up on the back of the NFC key

support_url

nullable string

Shows on the back of the issued NFC key.


support_phone_number

nullable string

Shows on the back of the issued NFC key.


support_email

nullable string

Shows on the back of the issued NFC key.


privacy_policy_url

nullable string

Shows on the back of the issued NFC key.


terms_and_conditions_url

nullable string

Shows on the back of the issued NFC key.

Read Card Template Enterprise only

Contact Us

Only available for enterprise customers - allows you to read basic info about an existing card template using our console API.

card_template_id

nullable string

Unique identifier for the card template to look up

Read Event Log Enterprise only

Contact Us

Only available for enterprise customers - allows you to read full event log for a given card template, including which passes were issued, how and by whom using our console API.

card_template_id

nullable string

Unique identifier for the card template to look up


filters

nullable object

Filters to reduce result size of event logs

device

nullable string

Must be either `mobile` or `watch`


start_date

nullable datetime

Must be in ISO8601 format


end_date

nullable datetime

Must be in ISO8601 format


event_type

nullable string

Must be either `issue`, `install`, `update`, `suspend`, `resume`, or `unlink`

© AccessGrid 2024
Privacy
Terms