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": "634",
      "type": "users",
      "attributes": {
        "name": "Ira Watsica",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Ira",
        "last_name": "Watsica",
        "full_name": "Ira Watsica",
        "full_name_with_team": "[Dicki LLC] Ira Watsica",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-24T09:28:54.065-08:00",
        "created_at": "2025-12-24T09:28:54.065-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "22b024aa-1b83-4547-98f3-98f383510abd",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ea83787c-bb5b-45ff-bbb5-17db3d48aed1",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "d721b323-1428-4abe-8f5a-fb2fa7e21db0",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "621a6d25-cb20-4845-b786-3488505bc56b",
              "type": "user_notification_rules"
            },
            {
              "id": "9ec07da0-5f4d-43c7-acf3-884d954434ed",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "633",
      "type": "users",
      "attributes": {
        "name": "Breanne Kuhlman",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Breanne",
        "last_name": "Kuhlman",
        "full_name": "Breanne Kuhlman",
        "full_name_with_team": "[Dicki LLC] Breanne Kuhlman",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-24T09:28:53.991-08:00",
        "created_at": "2025-12-24T09:28:53.991-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "498d69fd-1b9e-4c35-87e4-ef03cf6e030a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "7bb8b272-0927-47b8-8900-c290463020ca",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "d721b323-1428-4abe-8f5a-fb2fa7e21db0",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "ea292fe0-0998-48c2-bc01-f55ae22e2809",
              "type": "user_notification_rules"
            },
            {
              "id": "e319b1b8-73ec-405a-9fb6-6fb2fe0236d8",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "632",
      "type": "users",
      "attributes": {
        "name": "Susy Schamberger",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Susy",
        "last_name": "Schamberger",
        "full_name": "Susy Schamberger",
        "full_name_with_team": "[Dicki LLC] Susy Schamberger",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-24T09:28:53.872-08:00",
        "created_at": "2025-12-24T09:28:53.872-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "8f8c86a4-b3e3-417d-8281-cb3d6ea26c9a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "a200f5db-bcae-4b7d-98d0-1850d2a1e807",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "d721b323-1428-4abe-8f5a-fb2fa7e21db0",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "81a38305-efa0-40eb-9e68-46065ef40530",
              "type": "user_notification_rules"
            },
            {
              "id": "5dbc1703-8800-4597-9d72-598091001319",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "630",
      "type": "users",
      "attributes": {
        "name": "Candelaria Runte",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Candelaria",
        "last_name": "Runte",
        "full_name": "Candelaria Runte",
        "full_name_with_team": "[Dicki LLC] Candelaria Runte",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-24T09:28:53.513-08:00",
        "created_at": "2025-12-24T09:28:53.513-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "0e4a7cf1-3631-43f4-91a4-d5455e0a2e80",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "7bb8b272-0927-47b8-8900-c290463020ca",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "d721b323-1428-4abe-8f5a-fb2fa7e21db0",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "27c55f30-11de-4cc7-97f9-0242a8795eb3",
              "type": "user_notification_rules"
            },
            {
              "id": "e6c3874c-e68f-45b5-92a3-64d381c8dd23",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "629",
      "type": "users",
      "attributes": {
        "name": "Earnest Treutel",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Earnest",
        "last_name": "Treutel",
        "full_name": "Earnest Treutel",
        "full_name_with_team": "[Dicki LLC] Earnest Treutel",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-24T09:28:53.453-08:00",
        "created_at": "2025-12-24T09:28:53.453-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "06e7a5ba-447a-47e2-b522-5117b3ff0999",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "7bb8b272-0927-47b8-8900-c290463020ca",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "d721b323-1428-4abe-8f5a-fb2fa7e21db0",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "d362667c-2ba1-40e0-b5ce-e975f998b7bf",
              "type": "user_notification_rules"
            },
            {
              "id": "bd3bb1e8-6974-4962-829e-a9c8b6bd0ce7",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "628",
      "type": "users",
      "attributes": {
        "name": "Ezekiel Dooley",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Ezekiel",
        "last_name": "Dooley",
        "full_name": "Ezekiel Dooley",
        "full_name_with_team": "[Dicki LLC] Ezekiel Dooley",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-24T09:28:53.392-08:00",
        "created_at": "2025-12-24T09:28:53.392-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "db5c4d8b-7b21-4284-b2a1-a054243e7740",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "7bb8b272-0927-47b8-8900-c290463020ca",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "d721b323-1428-4abe-8f5a-fb2fa7e21db0",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "ae82fd3e-1daa-40e1-80ac-14220d952b7e",
              "type": "user_notification_rules"
            },
            {
              "id": "23ae1597-76d9-41ed-b64c-3b5a15d55db7",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "627",
      "type": "users",
      "attributes": {
        "name": "Alexis Okuneva",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Alexis",
        "last_name": "Okuneva",
        "full_name": "Alexis Okuneva",
        "full_name_with_team": "[Dicki LLC] Alexis Okuneva",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-24T09:28:53.331-08:00",
        "created_at": "2025-12-24T09:28:53.331-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "9ae41973-dd37-48ea-8a5f-a49d8e39f46a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "7bb8b272-0927-47b8-8900-c290463020ca",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "d721b323-1428-4abe-8f5a-fb2fa7e21db0",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "1fac2eff-c45b-447e-a99e-f442a1da8d40",
              "type": "user_notification_rules"
            },
            {
              "id": "d74069fe-9f8e-4fa5-9789-7fcd559ab208",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "626",
      "type": "users",
      "attributes": {
        "name": "Ambrose Zboncak",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Ambrose",
        "last_name": "Zboncak",
        "full_name": "Ambrose Zboncak",
        "full_name_with_team": "[Dicki LLC] Ambrose Zboncak",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-24T09:28:53.271-08:00",
        "created_at": "2025-12-24T09:28:53.271-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "32743897-f7ca-426b-8d7b-ae7ee1bab29d",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "7bb8b272-0927-47b8-8900-c290463020ca",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "d721b323-1428-4abe-8f5a-fb2fa7e21db0",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "e2730535-37fe-4fa2-af55-73afa5fe0aec",
              "type": "user_notification_rules"
            },
            {
              "id": "5ca7cc37-f242-4569-a26b-5c9f58664d65",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "625",
      "type": "users",
      "attributes": {
        "name": "Denisha Schamberger",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Denisha",
        "last_name": "Schamberger",
        "full_name": "Denisha Schamberger",
        "full_name_with_team": "[Dicki LLC] Denisha Schamberger",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-24T09:28:53.209-08:00",
        "created_at": "2025-12-24T09:28:53.209-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "bb259c55-ccd6-4362-975f-fa426c6f8cf5",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "7bb8b272-0927-47b8-8900-c290463020ca",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "d721b323-1428-4abe-8f5a-fb2fa7e21db0",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "1fdedca7-b9f9-4f6e-9d5b-79da1aef2bd8",
              "type": "user_notification_rules"
            },
            {
              "id": "1b01a603-1ac9-4adb-8a96-d7f3b9c71594",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "624",
      "type": "users",
      "attributes": {
        "name": "Susan Boyer",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Susan",
        "last_name": "Boyer",
        "full_name": "Susan Boyer",
        "full_name_with_team": "[Dicki LLC] Susan Boyer",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-24T09:28:53.145-08:00",
        "created_at": "2025-12-24T09:28:53.145-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "f19cb054-84c3-4877-9364-13b0c69e90b0",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "7bb8b272-0927-47b8-8900-c290463020ca",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "d721b323-1428-4abe-8f5a-fb2fa7e21db0",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "22aa06c6-8c88-4cf9-a95b-584b3c604b7c",
              "type": "user_notification_rules"
            },
            {
              "id": "ac960d43-0b5f-4c7c-9c77-4f1cee90cbf7",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "623",
      "type": "users",
      "attributes": {
        "name": "Bobbie Muller",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Bobbie",
        "last_name": "Muller",
        "full_name": "Bobbie Muller",
        "full_name_with_team": "[Dicki LLC] Bobbie Muller",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-24T09:28:53.076-08:00",
        "created_at": "2025-12-24T09:28:53.076-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "53830146-1d36-40d1-b99c-4153e3d62bd7",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "7bb8b272-0927-47b8-8900-c290463020ca",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "d721b323-1428-4abe-8f5a-fb2fa7e21db0",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "45a7545f-5068-4478-aba5-d0d7dc973239",
              "type": "user_notification_rules"
            },
            {
              "id": "54150c01-9c2d-45ad-ac3c-041590fc9175",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "622",
      "type": "users",
      "attributes": {
        "name": "Jerlene Smith",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Jerlene",
        "last_name": "Smith",
        "full_name": "Jerlene Smith",
        "full_name_with_team": "[Dicki LLC] Jerlene Smith",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-24T09:28:53.011-08:00",
        "created_at": "2025-12-24T09:28:53.011-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "550c2f82-cdea-459a-a613-5d4e2e8f0eb5",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "7bb8b272-0927-47b8-8900-c290463020ca",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "d721b323-1428-4abe-8f5a-fb2fa7e21db0",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "9a63c093-0a53-44cb-a1a5-4a89000f4499",
              "type": "user_notification_rules"
            },
            {
              "id": "21f6ec82-0d3c-4727-9c1e-6949eb8ca08b",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "621",
      "type": "users",
      "attributes": {
        "name": "Otis Nicolas",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Otis",
        "last_name": "Nicolas",
        "full_name": "Otis Nicolas",
        "full_name_with_team": "[Dicki LLC] Otis Nicolas",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-24T09:28:53.007-08:00",
        "created_at": "2025-12-24T09:28:52.767-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "1f1b1ef0-c778-4b7d-9d9d-d1dbb032c7f3",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "a200f5db-bcae-4b7d-98d0-1850d2a1e807",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "d721b323-1428-4abe-8f5a-fb2fa7e21db0",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "c1e6cf0b-197d-4396-a8f1-dfef59414261",
              "type": "user_notification_rules"
            },
            {
              "id": "d39d5be5-03c9-4047-9438-56898b8064df",
              "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