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": "Rigoberto Sipes",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Rigoberto",
        "last_name": "Sipes",
        "full_name": "Rigoberto Sipes",
        "full_name_with_team": "[Schroeder-Russel] Rigoberto Sipes",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-23T06:54:16.560-08:00",
        "created_at": "2026-01-23T06:54:16.560-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "ce39f34c-e9af-4942-9db8-e01c7af5e4ec",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "2ab71094-e3a1-4ee0-bd0f-912226a7896c",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7b253c90-45c5-4791-bcc4-63541969d9aa",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "7c1b1466-50e3-48dc-a0ac-2841c879f863",
              "type": "user_notification_rules"
            },
            {
              "id": "ffab83c3-fc62-48e6-bedd-c9f401a95b95",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "981",
      "type": "users",
      "attributes": {
        "name": "Ollie Hammes",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Ollie",
        "last_name": "Hammes",
        "full_name": "Ollie Hammes",
        "full_name_with_team": "[Schroeder-Russel] Ollie Hammes",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-23T06:54:16.482-08:00",
        "created_at": "2026-01-23T06:54:16.482-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "267ac114-8092-46c7-98f7-704da8dc6385",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "2de36345-8fe9-47bd-87d3-50cf6daa15fe",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7b253c90-45c5-4791-bcc4-63541969d9aa",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "4d755950-51b6-421f-b149-7859512dc253",
              "type": "user_notification_rules"
            },
            {
              "id": "f8854665-aa0c-4e53-8c3b-dc2aaa682f33",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "980",
      "type": "users",
      "attributes": {
        "name": "Klara Gutkowski",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Klara",
        "last_name": "Gutkowski",
        "full_name": "Klara Gutkowski",
        "full_name_with_team": "[Schroeder-Russel] Klara Gutkowski",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-23T06:54:16.400-08:00",
        "created_at": "2026-01-23T06:54:16.400-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "81918ef6-37c4-4c7e-92a9-bf0f3cfd2454",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "24fe0219-d8be-49ec-a077-ee8a6307ba26",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7b253c90-45c5-4791-bcc4-63541969d9aa",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "bebf09c7-9ec0-4e13-a1a9-3696238d590c",
              "type": "user_notification_rules"
            },
            {
              "id": "93188fea-13cd-44ca-8ea3-4ee7b56507f9",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "978",
      "type": "users",
      "attributes": {
        "name": "Lore Wunsch",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Lore",
        "last_name": "Wunsch",
        "full_name": "Lore Wunsch",
        "full_name_with_team": "[Schroeder-Russel] Lore Wunsch",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-23T06:54:16.106-08:00",
        "created_at": "2026-01-23T06:54:16.106-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "b1d75b81-1475-4bff-83a5-2f9605fdfc36",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "2de36345-8fe9-47bd-87d3-50cf6daa15fe",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7b253c90-45c5-4791-bcc4-63541969d9aa",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "0bd5b83c-616a-4fa2-a153-d619145d4db1",
              "type": "user_notification_rules"
            },
            {
              "id": "f845f7c1-86d9-4536-91bb-8f4cdf343dcc",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "977",
      "type": "users",
      "attributes": {
        "name": "Marquitta Powlowski",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Marquitta",
        "last_name": "Powlowski",
        "full_name": "Marquitta Powlowski",
        "full_name_with_team": "[Schroeder-Russel] Marquitta Powlowski",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-23T06:54:16.048-08:00",
        "created_at": "2026-01-23T06:54:16.048-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "7e9a1b42-5c7f-40ae-8e64-386b2154ff11",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "2de36345-8fe9-47bd-87d3-50cf6daa15fe",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7b253c90-45c5-4791-bcc4-63541969d9aa",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "9e482c1a-eeba-4d98-93f1-f5f9599a2885",
              "type": "user_notification_rules"
            },
            {
              "id": "d327af3d-cf74-4eec-9776-bde2d30dc919",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "976",
      "type": "users",
      "attributes": {
        "name": "Bradly Prosacco",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Bradly",
        "last_name": "Prosacco",
        "full_name": "Bradly Prosacco",
        "full_name_with_team": "[Schroeder-Russel] Bradly Prosacco",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-23T06:54:15.994-08:00",
        "created_at": "2026-01-23T06:54:15.994-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "288d4bb8-f97d-451c-ae3b-1b264a32848d",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "2de36345-8fe9-47bd-87d3-50cf6daa15fe",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7b253c90-45c5-4791-bcc4-63541969d9aa",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "51000d75-beb5-4433-b838-429403043aac",
              "type": "user_notification_rules"
            },
            {
              "id": "91f10769-1131-4c8c-8b5d-461ce208dea7",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "975",
      "type": "users",
      "attributes": {
        "name": "Candelaria Flatley",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Candelaria",
        "last_name": "Flatley",
        "full_name": "Candelaria Flatley",
        "full_name_with_team": "[Schroeder-Russel] Candelaria Flatley",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-23T06:54:15.936-08:00",
        "created_at": "2026-01-23T06:54:15.936-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "6aa0b18a-347d-4537-bcf8-11c81f6a3cde",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "2de36345-8fe9-47bd-87d3-50cf6daa15fe",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7b253c90-45c5-4791-bcc4-63541969d9aa",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "972a6380-f564-44ec-a58b-7869969ac6e3",
              "type": "user_notification_rules"
            },
            {
              "id": "f447f4ee-a09f-468b-af60-166660211e7d",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "974",
      "type": "users",
      "attributes": {
        "name": "Shemeka Casper",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Shemeka",
        "last_name": "Casper",
        "full_name": "Shemeka Casper",
        "full_name_with_team": "[Schroeder-Russel] Shemeka Casper",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-23T06:54:15.876-08:00",
        "created_at": "2026-01-23T06:54:15.876-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "820ec85f-bb1d-459e-aef8-add8a15c711b",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "2de36345-8fe9-47bd-87d3-50cf6daa15fe",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7b253c90-45c5-4791-bcc4-63541969d9aa",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "6878d11b-16f5-4774-a8c0-913821174e5c",
              "type": "user_notification_rules"
            },
            {
              "id": "45f80451-d0df-44ac-98e1-e10aeaf7088f",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "973",
      "type": "users",
      "attributes": {
        "name": "Yetta Wolf",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Yetta",
        "last_name": "Wolf",
        "full_name": "Yetta Wolf",
        "full_name_with_team": "[Schroeder-Russel] Yetta Wolf",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-23T06:54:15.818-08:00",
        "created_at": "2026-01-23T06:54:15.818-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "4a80ea11-26f6-483c-9aca-15e5233468d5",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "2de36345-8fe9-47bd-87d3-50cf6daa15fe",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7b253c90-45c5-4791-bcc4-63541969d9aa",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "cfcda9ac-9920-4e23-89f9-0c7abc8aee00",
              "type": "user_notification_rules"
            },
            {
              "id": "1401e4d0-3cec-4fde-ad9c-faa80aa4ca8e",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "972",
      "type": "users",
      "attributes": {
        "name": "Enrique Kirlin",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Enrique",
        "last_name": "Kirlin",
        "full_name": "Enrique Kirlin",
        "full_name_with_team": "[Schroeder-Russel] Enrique Kirlin",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-23T06:54:15.745-08:00",
        "created_at": "2026-01-23T06:54:15.745-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "c7b9b8c2-20e6-4ae7-8280-bafaab90f046",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "2de36345-8fe9-47bd-87d3-50cf6daa15fe",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7b253c90-45c5-4791-bcc4-63541969d9aa",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "88856ca2-7815-4b56-9710-71ce14b6541f",
              "type": "user_notification_rules"
            },
            {
              "id": "4711e4c6-6d13-47bb-8f8a-8608a5c1f19a",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "971",
      "type": "users",
      "attributes": {
        "name": "Harland Jacobs",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Harland",
        "last_name": "Jacobs",
        "full_name": "Harland Jacobs",
        "full_name_with_team": "[Schroeder-Russel] Harland Jacobs",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-23T06:54:15.673-08:00",
        "created_at": "2026-01-23T06:54:15.673-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "f108f82a-73e7-4454-abc1-7f1f1fbca945",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "2de36345-8fe9-47bd-87d3-50cf6daa15fe",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7b253c90-45c5-4791-bcc4-63541969d9aa",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "6319e889-7641-4b90-a6e1-cf3da2bceeaa",
              "type": "user_notification_rules"
            },
            {
              "id": "3ad62046-cc3e-443b-879e-fe97091755aa",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "970",
      "type": "users",
      "attributes": {
        "name": "Keeley Monahan",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Keeley",
        "last_name": "Monahan",
        "full_name": "Keeley Monahan",
        "full_name_with_team": "[Schroeder-Russel] Keeley Monahan",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-23T06:54:15.601-08:00",
        "created_at": "2026-01-23T06:54:15.601-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "e8151932-3fed-4004-ab3e-85e3eba705b0",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "2de36345-8fe9-47bd-87d3-50cf6daa15fe",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7b253c90-45c5-4791-bcc4-63541969d9aa",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "5309bf28-1c1a-44da-857b-22607306fb39",
              "type": "user_notification_rules"
            },
            {
              "id": "1944be60-62aa-459a-ac7a-7023d299e977",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "969",
      "type": "users",
      "attributes": {
        "name": "Mohammad Ledner",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Mohammad",
        "last_name": "Ledner",
        "full_name": "Mohammad Ledner",
        "full_name_with_team": "[Schroeder-Russel] Mohammad Ledner",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-23T06:54:15.597-08:00",
        "created_at": "2026-01-23T06:54:10.344-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "ea2cd9ac-e093-4ee3-adef-cfeddf1b6c50",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "24fe0219-d8be-49ec-a077-ee8a6307ba26",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7b253c90-45c5-4791-bcc4-63541969d9aa",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "112db05f-9ac4-4935-9119-1c59b3a22de1",
              "type": "user_notification_rules"
            },
            {
              "id": "b495d12c-5510-4747-a94a-fb51985b9ba6",
              "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