Skip to main content
GET
/
v1
/
users
/
{id}
Retrieves an user
curl --request GET \
  --url https://api.rootly.com/v1/users/{id} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "id": "565",
    "type": "users",
    "attributes": {
      "name": "Jenell Powlowski",
      "email": "vaughn_kautzer@emard-grimes.test",
      "phone": null,
      "phone_2": null,
      "first_name": "Jenell",
      "last_name": "Powlowski",
      "full_name": "Jenell Powlowski",
      "full_name_with_team": "[Dickens and Sons] Jenell Powlowski",
      "slack_id": null,
      "time_zone": "Etc/UTC",
      "updated_at": "2025-11-06T13:31:00.234-08:00",
      "created_at": "2025-11-06T13:30:59.666-08:00"
    },
    "relationships": {
      "email_addresses": {
        "data": [
          {
            "id": "e4007847-6d85-4eb6-b563-75697c65c908",
            "type": "user_email_addresses"
          }
        ]
      },
      "phone_numbers": {
        "data": []
      },
      "devices": {
        "data": []
      },
      "role": {
        "data": {
          "id": "4d16bc4c-84b4-4bd9-8d26-3d5d6a747f4d",
          "type": "roles"
        }
      },
      "on_call_role": {
        "data": {
          "id": "4bea3ec5-cc8b-474d-a7ae-59184b263b6a",
          "type": "on_call_roles"
        }
      },
      "teams": {
        "data": [
          {
            "id": "5401931f-8d8f-4b77-b81e-941e0600023f",
            "type": "groups"
          }
        ]
      },
      "schedules": {
        "data": [
          {
            "id": "a632e817-a420-4b3e-97a3-603ab5bfc142",
            "type": "schedules"
          }
        ]
      },
      "notification_rules": {
        "data": [
          {
            "id": "5235dbed-6b0f-4988-9f79-b9ab6a9b03b8",
            "type": "user_notification_rules"
          },
          {
            "id": "0e736d61-df4f-4815-9e1d-d5339eccac68",
            "type": "user_notification_rules"
          },
          {
            "id": "e19e414c-20a5-4ec1-9267-9f3e4fdcaad2",
            "type": "user_notification_rules"
          }
        ]
      }
    }
  },
  "included": [
    {
      "id": "5401931f-8d8f-4b77-b81e-941e0600023f",
      "type": "groups",
      "attributes": {
        "slug": "praesentium-illum-animi-minus",
        "name": "Praesentium illum animi minus.",
        "description": null,
        "color": "#F5D9C4",
        "position": 1,
        "notify_emails": [],
        "slack_channels": [],
        "slack_aliases": [],
        "pagerduty_id": null,
        "pagerduty_service_id": null,
        "backstage_id": null,
        "external_id": null,
        "opsgenie_id": null,
        "victor_ops_id": null,
        "pagertree_id": null,
        "cortex_id": null,
        "service_now_ci_sys_id": null,
        "user_ids": [
          565
        ],
        "admin_ids": [],
        "incidents_count": 0,
        "alert_urgency_id": null,
        "alerts_email_enabled": false,
        "alerts_email_address": "group-ee919e092529e41e9c03a5493757931d@email.rootly.com",
        "alert_broadcast_enabled": false,
        "alert_broadcast_channel": {},
        "incident_broadcast_enabled": false,
        "incident_broadcast_channel": {},
        "auto_add_members_when_attached": false,
        "created_at": "2025-11-06T13:31:08.445-08:00",
        "updated_at": "2025-11-06T13:31:08.476-08:00"
      },
      "relationships": {
        "users": {
          "data": [
            {
              "id": "565",
              "type": "users"
            }
          ]
        }
      }
    },
    {
      "id": "a632e817-a420-4b3e-97a3-603ab5bfc142",
      "type": "schedules",
      "attributes": {
        "name": "Schedule 30",
        "description": "Schedule description",
        "all_time_coverage": false,
        "slack_user_group": {},
        "slack_channel": null,
        "owner_user_id": 581,
        "owner_group_ids": [],
        "created_at": "2025-11-06T13:31:08.861-08:00",
        "updated_at": "2025-11-06T13:31:08.897-08:00"
      },
      "relationships": {
        "owner_user": {
          "data": {
            "id": "581",
            "type": "users"
          }
        },
        "escalation_policies": {
          "data": []
        }
      }
    },
    {
      "id": "5235dbed-6b0f-4988-9f79-b9ab6a9b03b8",
      "type": "user_notification_rules",
      "attributes": {
        "user_id": 565,
        "delay": 0,
        "position": 1,
        "user_email_address_id": "e4007847-6d85-4eb6-b563-75697c65c908",
        "user_call_number_id": null,
        "user_sms_number_id": null,
        "user_device_id": null,
        "enabled_contact_types": [
          "email"
        ],
        "created_at": "2025-11-06T13:30:59.730-08:00",
        "updated_at": "2025-11-06T13:30:59.730-08:00"
      }
    },
    {
      "id": "0e736d61-df4f-4815-9e1d-d5339eccac68",
      "type": "user_notification_rules",
      "attributes": {
        "user_id": 565,
        "delay": 1,
        "position": 1,
        "user_email_address_id": null,
        "user_call_number_id": null,
        "user_sms_number_id": null,
        "user_device_id": null,
        "enabled_contact_types": [
          "email"
        ],
        "created_at": "2025-11-06T13:31:08.957-08:00",
        "updated_at": "2025-11-06T13:31:08.957-08:00"
      }
    },
    {
      "id": "e19e414c-20a5-4ec1-9267-9f3e4fdcaad2",
      "type": "user_notification_rules",
      "attributes": {
        "user_id": 565,
        "delay": 0,
        "position": 2,
        "user_email_address_id": "e4007847-6d85-4eb6-b563-75697c65c908",
        "user_call_number_id": null,
        "user_sms_number_id": null,
        "user_device_id": null,
        "enabled_contact_types": [
          "email"
        ],
        "created_at": "2025-11-06T13:30:59.714-08:00",
        "updated_at": "2025-11-06T13:31:08.967-08:00"
      }
    }
  ]
}

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Query Parameters

include
enum<string>

comma separated if needed. eg: email_addresses,phone_numbers

Available options:
email_addresses,
phone_numbers,
devices,
role,
on_call_role,
teams,
schedules,
notification_rules

Response

user found with teams, schedules, and notification_rules includes

data
object
required