Skip to main content
POST
/
acs
/
users
/
get
await seam.acs.users.get({
  user_identity_id: "cde1ec76-5b0d-4b3e-9b85-d80dcc9b599c",
  acs_system_id: "f4d2b3fb-7fa5-47fd-b0d3-aa6da8f5b710",
});

/*
{
  "access_schedule": {
    "ends_at": "2025-06-12T11:00:00.000Z",
    "starts_at": "2025-06-10T15:00:00.000Z"
  },
  "acs_system_id": "f4d2b3fb-7fa5-47fd-b0d3-aa6da8f5b710",
  "acs_user_id": "42968059-0c89-40f3-b39a-fb80398d0d08",
  "connected_account_id": "c0175797-30f0-49f7-a228-2df115443ca7",
  "created_at": "2025-06-15T16:54:17.946482Z",
  "display_name": "Jane Doe",
  "email_address": "jane@example.com",
  "errors": [],
  "external_type": "salto_site_user",
  "external_type_display_name": "Salto site user",
  "full_name": "Jane Doe",
  "hid_acs_system_id": "2acbe47f-612c-422a-9205-7af292f74e7f",
  "is_managed": true,
  "is_suspended": false,
  "last_successful_sync_at": "2025-06-18T17:45:00.582Z",
  "pending_mutations": [],
  "phone_number": "+1555551000",
  "user_identity_email_address": "jane@example.com",
  "user_identity_full_name": "Jane Doe",
  "user_identity_id": "cde1ec76-5b0d-4b3e-9b85-d80dcc9b599c",
  "user_identity_phone_number": "+1555551000",
  "warnings": [],
  "workspace_id": "8d4868e3-2f95-4f33-8689-19420b3101cd"
}
*/
{
  "acs_user": {
    "acs_system_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "acs_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "connected_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "created_at": "2023-11-07T05:31:56Z",
    "display_name": "<string>",
    "errors": [
      {
        "error_code": "<string>",
        "message": "<string>",
        "created_at": "2023-11-07T05:31:56Z"
      }
    ],
    "last_successful_sync_at": "2023-11-07T05:31:56Z",
    "warnings": [
      {
        "created_at": "2023-11-07T05:31:56Z",
        "message": "<string>"
      }
    ],
    "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "access_schedule": {
      "ends_at": "2023-11-07T05:31:56Z",
      "starts_at": "2023-11-07T05:31:56Z"
    },
    "email": "jsmith@example.com",
    "email_address": "jsmith@example.com",
    "external_type_display_name": "<string>",
    "full_name": "<string>",
    "hid_acs_system_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "is_suspended": true,
    "pending_mutations": [
      {
        "created_at": "2023-11-07T05:31:56Z",
        "message": "<string>"
      }
    ],
    "phone_number": "<string>",
    "salto_space_metadata": {
      "audit_openings": true,
      "user_id": "<string>"
    },
    "user_identity_email_address": "<string>",
    "user_identity_full_name": "<string>",
    "user_identity_id": "<string>",
    "user_identity_phone_number": "<string>"
  },
  "ok": true
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
acs_system_id
string<uuid>

ID of the access system that you want to get. You can only provide acs_user_id or user_identity_id.

​
acs_user_id
string<uuid>

ID of the access system user that you want to get. You can only provide acs_user_id or user_identity_id.

​
user_identity_id
string<uuid>

ID of the user identity that you want to get. You can only provide acs_user_id or user_identity_id.

Response

OK

​
acs_user
object
required

Represents a user in an access system.

​
ok
boolean
required