Skip to main content
POST
/
api
/
accesscontrol
/
findAccessControlCredentialByGuestPass
Find access control credentials by guest pass
curl --request POST \
  --url https://api2.rhombussystems.com/api/accesscontrol/findAccessControlCredentialByGuestPass \
  --header 'Content-Type: application/json' \
  --header 'x-auth-apikey: <api-key>' \
  --header 'x-auth-scheme: <x-auth-scheme>' \
  --data '
{
  "filter": {
    "credTypeFilter": [],
    "lastUsedAccessControlledDoorUuidFilter": [
      "AAAAAAAAAAAAAAAAAAAAAA"
    ],
    "lastUsedAfterFilter": 123,
    "lastUsedBeforeFilter": 123,
    "lastUsedLocationUuidFilter": [
      "AAAAAAAAAAAAAAAAAAAAAA"
    ],
    "workflowStatusFilter": []
  },
  "guestPassUuid": "AAAAAAAAAAAAAAAAAAAAAA"
}
'
import requests

url = "https://api2.rhombussystems.com/api/accesscontrol/findAccessControlCredentialByGuestPass"

payload = {
"filter": {
"credTypeFilter": [],
"lastUsedAccessControlledDoorUuidFilter": ["AAAAAAAAAAAAAAAAAAAAAA"],
"lastUsedAfterFilter": 123,
"lastUsedBeforeFilter": 123,
"lastUsedLocationUuidFilter": ["AAAAAAAAAAAAAAAAAAAAAA"],
"workflowStatusFilter": []
},
"guestPassUuid": "AAAAAAAAAAAAAAAAAAAAAA"
}
headers = {
"x-auth-scheme": "<x-auth-scheme>",
"x-auth-apikey": "<api-key>",
"Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
method: 'POST',
headers: {
'x-auth-scheme': '<x-auth-scheme>',
'x-auth-apikey': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
filter: {
credTypeFilter: [],
lastUsedAccessControlledDoorUuidFilter: ['AAAAAAAAAAAAAAAAAAAAAA'],
lastUsedAfterFilter: 123,
lastUsedBeforeFilter: 123,
lastUsedLocationUuidFilter: ['AAAAAAAAAAAAAAAAAAAAAA'],
workflowStatusFilter: []
},
guestPassUuid: 'AAAAAAAAAAAAAAAAAAAAAA'
})
};

fetch('https://api2.rhombussystems.com/api/accesscontrol/findAccessControlCredentialByGuestPass', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
HttpResponse<String> response = Unirest.post("https://api2.rhombussystems.com/api/accesscontrol/findAccessControlCredentialByGuestPass")
.header("x-auth-scheme", "<x-auth-scheme>")
.header("x-auth-apikey", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"filter\": {\n \"credTypeFilter\": [],\n \"lastUsedAccessControlledDoorUuidFilter\": [\n \"AAAAAAAAAAAAAAAAAAAAAA\"\n ],\n \"lastUsedAfterFilter\": 123,\n \"lastUsedBeforeFilter\": 123,\n \"lastUsedLocationUuidFilter\": [\n \"AAAAAAAAAAAAAAAAAAAAAA\"\n ],\n \"workflowStatusFilter\": []\n },\n \"guestPassUuid\": \"AAAAAAAAAAAAAAAAAAAAAA\"\n}")
.asString();
{
  "credentials": [
    {
      "assigneeUuid": "AAAAAAAAAAAAAAAAAAAAAA",
      "createdAtMillis": 123,
      "endDateEpochSecExclusive": 123,
      "lastUsedAccessControlledDoorUuid": "AAAAAAAAAAAAAAAAAAAAAA",
      "lastUsedAtMillis": 123,
      "lastUsedLocationUuid": "AAAAAAAAAAAAAAAAAAAAAA",
      "lowercaseHexValue": "<string>",
      "managedCredUuid": "AAAAAAAAAAAAAAAAAAAAAA",
      "note": "<string>",
      "orgUuid": "AAAAAAAAAAAAAAAAAAAAAA",
      "startDateEpochSecInclusive": 123,
      "updatedAtMillis": 123,
      "userUuid": "AAAAAAAAAAAAAAAAAAAAAA",
      "uuid": "AAAAAAAAAAAAAAAAAAAAAA",
      "value": "<string>"
    }
  ]
}

Authorizations

x-auth-apikey
string
header
required

Your Rhombus API key. Must be accompanied by the x-auth-scheme header set to api-token (or partner-api-token for partner endpoints).

Headers

x-auth-scheme
enum<string>
default:api-token
required

Authentication scheme identifier. Use api-token for standard API key authentication, partner-api-token for partner API key authentication. Must be paired with the x-auth-apikey header containing your API key.

Available options:
api-token,
api,
partner-api-token,
partner-api

Body

application/json

Request to find access control credentials by guest pass.

filter
object

Filter criteria for finding credential history

guestPassUuid
string<RUUID> | null

base 64 (url-safe) uuid string

Example:

"AAAAAAAAAAAAAAAAAAAAAA"

Response

200 - application/json

OK

Response containing access control credentials found for a specific guest pass.

credentials
object[] | null

List of access control credentials

Credentials assigned to the pass.

Last modified on July 9, 2026