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": "Deonna Anderson",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Deonna",
        "last_name": "Anderson",
        "full_name": "Deonna Anderson",
        "full_name_with_team": "[Kilback and Sons] Deonna Anderson",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-19T06:25:01.038-08:00",
        "created_at": "2026-01-19T06:25:01.038-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "de632579-6a4b-42ff-925d-c13ffb7b4c9e",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "66ec0b5c-191a-44e8-b672-ad90b6a02cd4",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2025bffe-92cc-45b4-bb1e-c6e9b477550e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "2d4fd8c5-3828-48d0-a72b-254e0db2d4b2",
              "type": "user_notification_rules"
            },
            {
              "id": "2f12b7e1-7f62-4f03-86a3-38b766a96faa",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "981",
      "type": "users",
      "attributes": {
        "name": "Amanda Donnelly",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Amanda",
        "last_name": "Donnelly",
        "full_name": "Amanda Donnelly",
        "full_name_with_team": "[Kilback and Sons] Amanda Donnelly",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-19T06:25:00.941-08:00",
        "created_at": "2026-01-19T06:25:00.941-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "2c9d9791-30d5-4d8b-a3d8-a8a1ee70ebd4",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "eee901e4-27cc-471b-b30c-cb3a7b974881",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2025bffe-92cc-45b4-bb1e-c6e9b477550e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "552cf6f0-0471-48a0-89ea-d26305928e27",
              "type": "user_notification_rules"
            },
            {
              "id": "4dbe6aa7-9731-4749-af66-56a4db831446",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "980",
      "type": "users",
      "attributes": {
        "name": "Jammie Bergnaum",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Jammie",
        "last_name": "Bergnaum",
        "full_name": "Jammie Bergnaum",
        "full_name_with_team": "[Kilback and Sons] Jammie Bergnaum",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-19T06:25:00.818-08:00",
        "created_at": "2026-01-19T06:25:00.818-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "6c6a2c2a-9660-4641-921f-25444d7bda80",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "1fe5c038-752b-4a96-882d-a4e9418b9027",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2025bffe-92cc-45b4-bb1e-c6e9b477550e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "5a33634c-90da-46c3-acdd-7881c6518506",
              "type": "user_notification_rules"
            },
            {
              "id": "48e010b5-b6d5-4704-964e-aa16170f2fcc",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "978",
      "type": "users",
      "attributes": {
        "name": "Shanell Skiles",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Shanell",
        "last_name": "Skiles",
        "full_name": "Shanell Skiles",
        "full_name_with_team": "[Kilback and Sons] Shanell Skiles",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-19T06:25:00.404-08:00",
        "created_at": "2026-01-19T06:25:00.404-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "c39f1863-56a4-4193-a8fe-76f97afc941a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "eee901e4-27cc-471b-b30c-cb3a7b974881",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2025bffe-92cc-45b4-bb1e-c6e9b477550e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "1755ff99-2e14-4464-bd39-0ebc8585d394",
              "type": "user_notification_rules"
            },
            {
              "id": "1c96b491-7220-4413-adbd-2de535f3c130",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "977",
      "type": "users",
      "attributes": {
        "name": "Cecelia Bergstrom",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Cecelia",
        "last_name": "Bergstrom",
        "full_name": "Cecelia Bergstrom",
        "full_name_with_team": "[Kilback and Sons] Cecelia Bergstrom",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-19T06:25:00.319-08:00",
        "created_at": "2026-01-19T06:25:00.319-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "c6cce7ad-54c8-4c34-a618-d32755c668b1",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "eee901e4-27cc-471b-b30c-cb3a7b974881",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2025bffe-92cc-45b4-bb1e-c6e9b477550e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "8e520b18-61a9-4c3e-a49e-c8ddac0af293",
              "type": "user_notification_rules"
            },
            {
              "id": "0641ff9a-a0c9-4228-85cc-ad3b342b9664",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "976",
      "type": "users",
      "attributes": {
        "name": "Casandra Koepp",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Casandra",
        "last_name": "Koepp",
        "full_name": "Casandra Koepp",
        "full_name_with_team": "[Kilback and Sons] Casandra Koepp",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-19T06:25:00.240-08:00",
        "created_at": "2026-01-19T06:25:00.240-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "a82c3c8a-3f40-4c59-82b6-c91908fd529a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "eee901e4-27cc-471b-b30c-cb3a7b974881",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2025bffe-92cc-45b4-bb1e-c6e9b477550e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "f0a42b49-99f5-462f-a2da-fc357e6fc101",
              "type": "user_notification_rules"
            },
            {
              "id": "b5ab907a-5a8a-46fc-9b71-924a9a0ad6c1",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "975",
      "type": "users",
      "attributes": {
        "name": "Derick Kautzer",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Derick",
        "last_name": "Kautzer",
        "full_name": "Derick Kautzer",
        "full_name_with_team": "[Kilback and Sons] Derick Kautzer",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-19T06:25:00.158-08:00",
        "created_at": "2026-01-19T06:25:00.158-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "003f72ba-fb85-4376-83cc-de0e14a60b67",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "eee901e4-27cc-471b-b30c-cb3a7b974881",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2025bffe-92cc-45b4-bb1e-c6e9b477550e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "3867012c-432a-43e1-a27d-127e291a023a",
              "type": "user_notification_rules"
            },
            {
              "id": "1d65ff57-13d7-481e-961c-73c691773706",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "974",
      "type": "users",
      "attributes": {
        "name": "Eboni Botsford",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Eboni",
        "last_name": "Botsford",
        "full_name": "Eboni Botsford",
        "full_name_with_team": "[Kilback and Sons] Eboni Botsford",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-19T06:25:00.075-08:00",
        "created_at": "2026-01-19T06:25:00.075-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "0376827c-931a-4584-8bd6-c06988fd5a2a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "eee901e4-27cc-471b-b30c-cb3a7b974881",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2025bffe-92cc-45b4-bb1e-c6e9b477550e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "caf6596d-c67d-4410-822f-6956781f4d1b",
              "type": "user_notification_rules"
            },
            {
              "id": "7aae0414-7731-412c-bb8c-cab780de343e",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "973",
      "type": "users",
      "attributes": {
        "name": "Kieth McGlynn",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Kieth",
        "last_name": "McGlynn",
        "full_name": "Kieth McGlynn",
        "full_name_with_team": "[Kilback and Sons] Kieth McGlynn",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-19T06:24:59.990-08:00",
        "created_at": "2026-01-19T06:24:59.990-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "668e2ace-8ce3-46ff-b6a5-a89b9b3e9fa1",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "eee901e4-27cc-471b-b30c-cb3a7b974881",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2025bffe-92cc-45b4-bb1e-c6e9b477550e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "e5d4083b-e3bc-440e-8aa1-6afb0421580f",
              "type": "user_notification_rules"
            },
            {
              "id": "a2d4a670-94e4-43a1-a16b-89b8b42dc392",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "972",
      "type": "users",
      "attributes": {
        "name": "Robin Dibbert",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Robin",
        "last_name": "Dibbert",
        "full_name": "Robin Dibbert",
        "full_name_with_team": "[Kilback and Sons] Robin Dibbert",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-19T06:24:59.905-08:00",
        "created_at": "2026-01-19T06:24:59.905-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "14098a04-59bc-45b4-96f7-6e6e44408bb2",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "eee901e4-27cc-471b-b30c-cb3a7b974881",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2025bffe-92cc-45b4-bb1e-c6e9b477550e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "39047730-9aed-4847-8d57-97fd3458d944",
              "type": "user_notification_rules"
            },
            {
              "id": "86040330-e755-4155-8f4f-e06dc4ba19fa",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "971",
      "type": "users",
      "attributes": {
        "name": "Alejandra Waters",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Alejandra",
        "last_name": "Waters",
        "full_name": "Alejandra Waters",
        "full_name_with_team": "[Kilback and Sons] Alejandra Waters",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-19T06:24:59.786-08:00",
        "created_at": "2026-01-19T06:24:59.786-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "62b98f5d-e44c-4b34-b6ff-fb75a117a38e",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "eee901e4-27cc-471b-b30c-cb3a7b974881",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2025bffe-92cc-45b4-bb1e-c6e9b477550e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "edbbfee5-af4a-48a1-b61d-13afebecd3dc",
              "type": "user_notification_rules"
            },
            {
              "id": "40863ed4-d0ff-4ab2-b9c2-0d753bcda4c0",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "970",
      "type": "users",
      "attributes": {
        "name": "Dorian Huels",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Dorian",
        "last_name": "Huels",
        "full_name": "Dorian Huels",
        "full_name_with_team": "[Kilback and Sons] Dorian Huels",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-19T06:24:59.704-08:00",
        "created_at": "2026-01-19T06:24:59.704-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "07a0eac4-464e-4086-93e8-5f4cf70a770c",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "eee901e4-27cc-471b-b30c-cb3a7b974881",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2025bffe-92cc-45b4-bb1e-c6e9b477550e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "ae67ade7-5d81-4300-a6d7-c0dfd81328c0",
              "type": "user_notification_rules"
            },
            {
              "id": "46146302-b2a4-49d7-865c-88714a1f511b",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "969",
      "type": "users",
      "attributes": {
        "name": "Tiffanie Carroll",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Tiffanie",
        "last_name": "Carroll",
        "full_name": "Tiffanie Carroll",
        "full_name_with_team": "[Kilback and Sons] Tiffanie Carroll",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-19T06:24:59.699-08:00",
        "created_at": "2026-01-19T06:24:59.399-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "bb523cfc-0015-4816-8372-751830411157",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "1fe5c038-752b-4a96-882d-a4e9418b9027",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2025bffe-92cc-45b4-bb1e-c6e9b477550e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "b8f6b701-ac1b-4fcd-a3f0-8a7e67735cc2",
              "type": "user_notification_rules"
            },
            {
              "id": "7139cb34-8a46-4b8e-abe3-4416bb9894bf",
              "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