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": "982",
      "type": "users",
      "attributes": {
        "name": "Bertie Kreiger",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Bertie",
        "last_name": "Kreiger",
        "full_name": "Bertie Kreiger",
        "full_name_with_team": "[Harber Inc] Bertie Kreiger",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T11:06:34.624-08:00",
        "created_at": "2026-01-16T11:06:34.624-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "7ad5f4a7-1407-463a-baf2-077dfdd026c7",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e80a99ac-a60d-4d86-a541-1c2de2c71032",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "e16bede6-177f-407f-9914-a46bb8a86956",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "caccb0c3-95d3-4884-a63f-0081e3803ac8",
              "type": "user_notification_rules"
            },
            {
              "id": "488ccd7e-618f-4def-8c0f-9ef9454aecc1",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "981",
      "type": "users",
      "attributes": {
        "name": "Laurence Schmeler",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Laurence",
        "last_name": "Schmeler",
        "full_name": "Laurence Schmeler",
        "full_name_with_team": "[Harber Inc] Laurence Schmeler",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T11:06:34.544-08:00",
        "created_at": "2026-01-16T11:06:34.544-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "1225352e-df75-4b95-9a89-1f0f595040a1",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d6a1696d-bd84-494d-83db-cbf36d8c0a1b",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "e16bede6-177f-407f-9914-a46bb8a86956",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "993046d6-8934-4c2d-a467-f693d98f5b15",
              "type": "user_notification_rules"
            },
            {
              "id": "a9e53173-c20b-44d0-a557-316345d54de2",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "980",
      "type": "users",
      "attributes": {
        "name": "Clorinda Quitzon",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Clorinda",
        "last_name": "Quitzon",
        "full_name": "Clorinda Quitzon",
        "full_name_with_team": "[Harber Inc] Clorinda Quitzon",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T11:06:34.431-08:00",
        "created_at": "2026-01-16T11:06:34.431-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "0d64684c-64f2-4f24-bde7-507af8f54f37",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "36a5a4a2-52ad-4209-9e97-2ba1b142e94f",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "e16bede6-177f-407f-9914-a46bb8a86956",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "6233e5c3-84a1-4dc5-8b4d-cec015f73bea",
              "type": "user_notification_rules"
            },
            {
              "id": "6fe2e5f5-0eac-4a50-bcb2-0a17ff0cbbdf",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "978",
      "type": "users",
      "attributes": {
        "name": "Arthur Hintz",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Arthur",
        "last_name": "Hintz",
        "full_name": "Arthur Hintz",
        "full_name_with_team": "[Harber Inc] Arthur Hintz",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T11:06:34.049-08:00",
        "created_at": "2026-01-16T11:06:34.049-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "b4837fd1-a286-429f-9292-8d34ccaaef76",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d6a1696d-bd84-494d-83db-cbf36d8c0a1b",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "e16bede6-177f-407f-9914-a46bb8a86956",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "99cb3073-9b21-4830-916d-21a0147bf2af",
              "type": "user_notification_rules"
            },
            {
              "id": "b197fed4-064c-4f6f-8206-848b01bdb223",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "977",
      "type": "users",
      "attributes": {
        "name": "Shizue Schinner",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Shizue",
        "last_name": "Schinner",
        "full_name": "Shizue Schinner",
        "full_name_with_team": "[Harber Inc] Shizue Schinner",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T11:06:33.968-08:00",
        "created_at": "2026-01-16T11:06:33.968-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "e36fa1c3-2955-4911-89fc-4c4cb070e67d",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d6a1696d-bd84-494d-83db-cbf36d8c0a1b",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "e16bede6-177f-407f-9914-a46bb8a86956",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "36df46f6-f77e-4b8a-b50e-04cd6c4d421c",
              "type": "user_notification_rules"
            },
            {
              "id": "7d4274a2-8b01-45a8-959e-9788e70ef3ac",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "976",
      "type": "users",
      "attributes": {
        "name": "Jayson Reynolds",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Jayson",
        "last_name": "Reynolds",
        "full_name": "Jayson Reynolds",
        "full_name_with_team": "[Harber Inc] Jayson Reynolds",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T11:06:33.877-08:00",
        "created_at": "2026-01-16T11:06:33.877-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "c85174dc-c165-4f55-a95d-27451614e730",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d6a1696d-bd84-494d-83db-cbf36d8c0a1b",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "e16bede6-177f-407f-9914-a46bb8a86956",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "27cfa670-1e8b-41a4-bdc2-e0d5269057b2",
              "type": "user_notification_rules"
            },
            {
              "id": "983e853d-f2d6-44ef-a7e2-e1f2e6fad782",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "975",
      "type": "users",
      "attributes": {
        "name": "Dawn Veum",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Dawn",
        "last_name": "Veum",
        "full_name": "Dawn Veum",
        "full_name_with_team": "[Harber Inc] Dawn Veum",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T11:06:33.801-08:00",
        "created_at": "2026-01-16T11:06:33.801-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "96c99c9f-eb64-4b33-9dcd-d3b4a22f2de6",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d6a1696d-bd84-494d-83db-cbf36d8c0a1b",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "e16bede6-177f-407f-9914-a46bb8a86956",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "7d6068db-2306-4cca-a6cc-283a5acfe9b2",
              "type": "user_notification_rules"
            },
            {
              "id": "1ab5af10-541d-4aa8-8196-87d6245f966c",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "974",
      "type": "users",
      "attributes": {
        "name": "Francesco Marquardt",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Francesco",
        "last_name": "Marquardt",
        "full_name": "Francesco Marquardt",
        "full_name_with_team": "[Harber Inc] Francesco Marquardt",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T11:06:33.726-08:00",
        "created_at": "2026-01-16T11:06:33.726-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "63bc8003-bb93-4ebd-b082-b5565c597fa9",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d6a1696d-bd84-494d-83db-cbf36d8c0a1b",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "e16bede6-177f-407f-9914-a46bb8a86956",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "ddcd6b68-3d5a-4e8c-938e-6d71c5639043",
              "type": "user_notification_rules"
            },
            {
              "id": "e63e86ba-3609-4729-b1de-1ccd8866706d",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "973",
      "type": "users",
      "attributes": {
        "name": "Vannesa Zieme",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Vannesa",
        "last_name": "Zieme",
        "full_name": "Vannesa Zieme",
        "full_name_with_team": "[Harber Inc] Vannesa Zieme",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T11:06:33.649-08:00",
        "created_at": "2026-01-16T11:06:33.649-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "30321ff3-9e32-4781-9542-3a82dc6255fd",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d6a1696d-bd84-494d-83db-cbf36d8c0a1b",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "e16bede6-177f-407f-9914-a46bb8a86956",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "ef84a687-feb4-4d03-84d9-204b56f33cb3",
              "type": "user_notification_rules"
            },
            {
              "id": "d0e4ab4f-9742-4856-b4dd-0519a10e419f",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "972",
      "type": "users",
      "attributes": {
        "name": "Tora Lehner",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Tora",
        "last_name": "Lehner",
        "full_name": "Tora Lehner",
        "full_name_with_team": "[Harber Inc] Tora Lehner",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T11:06:33.574-08:00",
        "created_at": "2026-01-16T11:06:33.574-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "86257b51-257c-4c34-8358-7dc0d95b2875",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d6a1696d-bd84-494d-83db-cbf36d8c0a1b",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "e16bede6-177f-407f-9914-a46bb8a86956",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "a633d536-30d3-4124-8f64-cddddf6b3d47",
              "type": "user_notification_rules"
            },
            {
              "id": "aba805a8-52c8-488e-9c82-e66e87d91bbb",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "971",
      "type": "users",
      "attributes": {
        "name": "Delbert Ritchie",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Delbert",
        "last_name": "Ritchie",
        "full_name": "Delbert Ritchie",
        "full_name_with_team": "[Harber Inc] Delbert Ritchie",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T11:06:33.451-08:00",
        "created_at": "2026-01-16T11:06:33.451-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "b7f1d0a1-98e1-4275-9f76-47d68925dd57",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d6a1696d-bd84-494d-83db-cbf36d8c0a1b",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "e16bede6-177f-407f-9914-a46bb8a86956",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "c8d8273f-9651-4c89-b05a-5d15001e2041",
              "type": "user_notification_rules"
            },
            {
              "id": "45339ebd-e5df-405c-82e5-149ba812378b",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "970",
      "type": "users",
      "attributes": {
        "name": "Shari Brekke",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Shari",
        "last_name": "Brekke",
        "full_name": "Shari Brekke",
        "full_name_with_team": "[Harber Inc] Shari Brekke",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T11:06:33.368-08:00",
        "created_at": "2026-01-16T11:06:33.368-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "5f50c2c4-6962-4130-8258-e1d29d27feee",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d6a1696d-bd84-494d-83db-cbf36d8c0a1b",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "e16bede6-177f-407f-9914-a46bb8a86956",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "6ea0e567-5fdc-488b-b65e-227e6bb87ecf",
              "type": "user_notification_rules"
            },
            {
              "id": "beb4a765-3e1d-452a-8254-6d23818d3cf6",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "969",
      "type": "users",
      "attributes": {
        "name": "Norman Hills",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Norman",
        "last_name": "Hills",
        "full_name": "Norman Hills",
        "full_name_with_team": "[Harber Inc] Norman Hills",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T11:06:33.363-08:00",
        "created_at": "2026-01-16T11:06:33.053-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "c1566a02-2a46-4c9e-ae78-65c727dd4951",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "36a5a4a2-52ad-4209-9e97-2ba1b142e94f",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "e16bede6-177f-407f-9914-a46bb8a86956",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "176e918a-0423-4b4c-902f-7e95ee967fd1",
              "type": "user_notification_rules"
            },
            {
              "id": "75caa56c-dd9a-4b2a-b73f-49e043649563",
              "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