Skip to main content
GET
/
v1
/
users
List users
curl --request GET \
  --url https://api.rootly.com/v1/users \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "1096",
      "type": "users",
      "attributes": {
        "name": "Tasha Hagenes",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Tasha",
        "last_name": "Hagenes",
        "full_name": "Tasha Hagenes",
        "full_name_with_team": "[Predovic Inc] Tasha Hagenes",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-07T16:51:33.114-08:00",
        "created_at": "2026-02-07T16:51:33.114-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "9a7f9cbc-735a-4227-8b5f-5354ae6835b9",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c0bce8c2-3606-4413-9ad9-576225448164",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "25c25d7c-bccf-442e-8f76-a68b0f3bba56",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "6a871537-7c53-4726-b874-e469041671c8",
              "type": "user_notification_rules"
            },
            {
              "id": "9e993244-c48a-4512-95b2-6426d9f620dd",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1095",
      "type": "users",
      "attributes": {
        "name": "Cletus Muller",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Cletus",
        "last_name": "Muller",
        "full_name": "Cletus Muller",
        "full_name_with_team": "[Predovic Inc] Cletus Muller",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-07T16:51:33.047-08:00",
        "created_at": "2026-02-07T16:51:33.047-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "fce8a3eb-9e98-46aa-9a48-84852b4c9bc1",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "966cb361-614d-44be-9711-0a20e5bc1495",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "25c25d7c-bccf-442e-8f76-a68b0f3bba56",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "4a9d7363-b258-4ea6-b6c4-fc7381412a1c",
              "type": "user_notification_rules"
            },
            {
              "id": "6e2ae7c7-5803-45c5-a447-69da4a44105e",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1094",
      "type": "users",
      "attributes": {
        "name": "Hollis Will",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Hollis",
        "last_name": "Will",
        "full_name": "Hollis Will",
        "full_name_with_team": "[Predovic Inc] Hollis Will",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-07T16:51:32.963-08:00",
        "created_at": "2026-02-07T16:51:32.963-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "3b501da8-fdf9-453d-914e-ae364644704d",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "61d30a39-db05-4e43-b88d-5f73bc4ed23b",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "25c25d7c-bccf-442e-8f76-a68b0f3bba56",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "327dc7f5-0437-4cc4-85d1-3b32f5e8f16c",
              "type": "user_notification_rules"
            },
            {
              "id": "b3b19ab6-b38f-405b-934c-d9cafea6c6ee",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1092",
      "type": "users",
      "attributes": {
        "name": "Shizue Cummerata",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Shizue",
        "last_name": "Cummerata",
        "full_name": "Shizue Cummerata",
        "full_name_with_team": "[Predovic Inc] Shizue Cummerata",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-07T16:51:32.650-08:00",
        "created_at": "2026-02-07T16:51:32.650-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "a59d6db0-5dbf-4b73-85f4-d647772b41f6",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "966cb361-614d-44be-9711-0a20e5bc1495",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "25c25d7c-bccf-442e-8f76-a68b0f3bba56",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "726ce54f-c75e-430d-bfe0-deab3885e9ad",
              "type": "user_notification_rules"
            },
            {
              "id": "e57ecddb-19c1-4d5a-aebf-fc4fab55fd14",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1091",
      "type": "users",
      "attributes": {
        "name": "Antione Herzog",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Antione",
        "last_name": "Herzog",
        "full_name": "Antione Herzog",
        "full_name_with_team": "[Predovic Inc] Antione Herzog",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-07T16:51:32.588-08:00",
        "created_at": "2026-02-07T16:51:32.588-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "ce83d5ff-dc88-410e-a202-a3b0afc6205a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "966cb361-614d-44be-9711-0a20e5bc1495",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "25c25d7c-bccf-442e-8f76-a68b0f3bba56",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "c17fe8b7-f3b4-4c03-b1fa-e561fc46f6c9",
              "type": "user_notification_rules"
            },
            {
              "id": "7bce1573-bef6-4857-811c-50fa324e0814",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1090",
      "type": "users",
      "attributes": {
        "name": "Chin O'Connell",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Chin",
        "last_name": "O'Connell",
        "full_name": "Chin O'Connell",
        "full_name_with_team": "[Predovic Inc] Chin O'Connell",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-07T16:51:32.529-08:00",
        "created_at": "2026-02-07T16:51:32.529-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "62f422b7-6215-4e3f-881d-59f4934fb75b",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "966cb361-614d-44be-9711-0a20e5bc1495",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "25c25d7c-bccf-442e-8f76-a68b0f3bba56",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "4d7bb83a-20ac-42f5-bdf4-94fba12909be",
              "type": "user_notification_rules"
            },
            {
              "id": "66cc515e-40c4-47d1-a420-9cdf31642541",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1089",
      "type": "users",
      "attributes": {
        "name": "Hope Murphy",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Hope",
        "last_name": "Murphy",
        "full_name": "Hope Murphy",
        "full_name_with_team": "[Predovic Inc] Hope Murphy",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-07T16:51:32.469-08:00",
        "created_at": "2026-02-07T16:51:32.469-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "34b07bc3-e2d1-4d76-a7f8-9951734d377a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "966cb361-614d-44be-9711-0a20e5bc1495",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "25c25d7c-bccf-442e-8f76-a68b0f3bba56",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "032bd414-8d93-4696-9b21-f42cc11713a1",
              "type": "user_notification_rules"
            },
            {
              "id": "e8875735-6d2e-42b6-9ab2-c6a51a4c68da",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1088",
      "type": "users",
      "attributes": {
        "name": "Hershel Nicolas",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Hershel",
        "last_name": "Nicolas",
        "full_name": "Hershel Nicolas",
        "full_name_with_team": "[Predovic Inc] Hershel Nicolas",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-07T16:51:32.410-08:00",
        "created_at": "2026-02-07T16:51:32.410-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "c6e724d6-d782-4d33-8af2-55fb3ab1d746",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "966cb361-614d-44be-9711-0a20e5bc1495",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "25c25d7c-bccf-442e-8f76-a68b0f3bba56",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "fcc17edb-ec82-456b-b5bf-caa641476bc3",
              "type": "user_notification_rules"
            },
            {
              "id": "58ba42cd-1236-4fc3-857c-53d66fc18b90",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1087",
      "type": "users",
      "attributes": {
        "name": "Theron Turcotte",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Theron",
        "last_name": "Turcotte",
        "full_name": "Theron Turcotte",
        "full_name_with_team": "[Predovic Inc] Theron Turcotte",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-07T16:51:32.331-08:00",
        "created_at": "2026-02-07T16:51:32.331-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "9dac5de9-dede-4874-bbfb-02791c8e3a3d",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "966cb361-614d-44be-9711-0a20e5bc1495",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "25c25d7c-bccf-442e-8f76-a68b0f3bba56",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "a750dd9d-669d-430b-a8fb-f54a69daa335",
              "type": "user_notification_rules"
            },
            {
              "id": "892e1bfb-f8a3-4a62-aff7-a4690ace6321",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1086",
      "type": "users",
      "attributes": {
        "name": "Frances Grady",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Frances",
        "last_name": "Grady",
        "full_name": "Frances Grady",
        "full_name_with_team": "[Predovic Inc] Frances Grady",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-07T16:51:32.274-08:00",
        "created_at": "2026-02-07T16:51:32.274-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "6d5c59a6-0528-4e2c-b8af-d5427b899a81",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "966cb361-614d-44be-9711-0a20e5bc1495",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "25c25d7c-bccf-442e-8f76-a68b0f3bba56",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "4ae41b44-90b8-417e-af3f-f38596519ed0",
              "type": "user_notification_rules"
            },
            {
              "id": "84101826-acc4-4e17-850b-b16322eab5c9",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1085",
      "type": "users",
      "attributes": {
        "name": "Osvaldo Schmeler",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Osvaldo",
        "last_name": "Schmeler",
        "full_name": "Osvaldo Schmeler",
        "full_name_with_team": "[Predovic Inc] Osvaldo Schmeler",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-07T16:51:32.213-08:00",
        "created_at": "2026-02-07T16:51:32.213-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "680f0271-7695-4ceb-972b-b401574e6720",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "966cb361-614d-44be-9711-0a20e5bc1495",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "25c25d7c-bccf-442e-8f76-a68b0f3bba56",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "15caf747-db8f-4c73-8a63-0bda2272f23f",
              "type": "user_notification_rules"
            },
            {
              "id": "1e8e0195-2bc3-4df4-a22e-674cae9e0d7c",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1084",
      "type": "users",
      "attributes": {
        "name": "Ian Lebsack",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Ian",
        "last_name": "Lebsack",
        "full_name": "Ian Lebsack",
        "full_name_with_team": "[Predovic Inc] Ian Lebsack",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-07T16:51:32.153-08:00",
        "created_at": "2026-02-07T16:51:32.153-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "388a6a32-a5bc-465b-857e-6ef2c592a8d3",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "966cb361-614d-44be-9711-0a20e5bc1495",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "25c25d7c-bccf-442e-8f76-a68b0f3bba56",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "98c66760-8823-453b-9d94-2a832b746ec8",
              "type": "user_notification_rules"
            },
            {
              "id": "91bb9a93-edfd-460a-a277-3879e91783bf",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1083",
      "type": "users",
      "attributes": {
        "name": "Candi Olson",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Candi",
        "last_name": "Olson",
        "full_name": "Candi Olson",
        "full_name_with_team": "[Predovic Inc] Candi Olson",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-07T16:51:32.149-08:00",
        "created_at": "2026-02-07T16:51:31.880-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "84ed962b-5d7c-4052-a249-d2ec42738ccf",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "61d30a39-db05-4e43-b88d-5f73bc4ed23b",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "25c25d7c-bccf-442e-8f76-a68b0f3bba56",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "6ed9a12f-3f54-4cf3-a005-8283bd613e23",
              "type": "user_notification_rules"
            },
            {
              "id": "7e6612a0-7d30-41c8-86a7-c531a75c75e0",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    }
  ],
  "links": {
    "self": "http://www.example.com/v1/users?page%5Bnumber%5D=1&page%5Bsize%5D=50",
    "first": "http://www.example.com/v1/users?page%5Bnumber%5D=1&page%5Bsize%5D=50",
    "prev": null,
    "next": null,
    "last": "http://www.example.com/v1/users?page%5Bnumber%5D=1&page%5Bsize%5D=50"
  },
  "meta": {
    "current_page": 1,
    "next_page": null,
    "prev_page": null,
    "total_count": 13,
    "total_pages": 1
  }
}

Authorizations

Authorization
string
header
required

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

Query Parameters

page[number]
integer
page[size]
integer
filter[email]
string
filter[created_at][gt]
string
filter[created_at][gte]
string
filter[created_at][lt]
string
filter[created_at][lte]
string
sort
enum<string>

comma separated if needed. eg: created_at,updated_at

Available options:
created_at,
-created_at,
updated_at,
-updated_at
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

data
object[]
required
meta
object
required