Searching Access Records

You can search for access records using a variety of fields. The query can match:

If no search query is provided, the API will return all access records. Results are returned as a JSON array containing Access objects.

Filter by Key ID

You can search for accesses associated with a specific key. This will return all ongoing or future accesses for the specified key.

curl -u 'test@yourdomain.com:{password}' \
  https://www.keycafe.com/v0/access?key=123456 \
  -H "Accept: application/json"

You can also filter by user ID to retrieve all ongoing or future accesses assigned to a specific user.

curl -u 'test@yourdomain.com:{password}' \
  https://www.keycafe.com/v0/access?user=123456 \
  -H "Accept: application/json"

To retrieve all accesses created for keys belonging to a specific organization, you can search by organization ID.

curl -u 'test@yourdomain.com:{password}' \
  https://www.keycafe.com/v0/access?organization=123456 \
  -H "Accept: application/json"

Search results are paginated with 50 results per page. Use the Link response header to access additional pages:

Link: <https://www.keycafe.com/v0/access?query=bob&page=2>; rel="next",
      <https://www.keycafe.com/v0/access?query=bob&page=5>; rel="last"