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": "1100",
      "type": "users",
      "attributes": {
        "name": "Wanda King",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Wanda",
        "last_name": "King",
        "full_name": "Wanda King",
        "full_name_with_team": "[Osinski, Kozey and Hintz] Wanda King",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-12T08:09:53.994-08:00",
        "created_at": "2026-02-12T08:09:53.994-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "1f0cea77-6b3b-442e-a889-a997781db367",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c2b7e44f-9de3-4c08-a77b-152d686cb296",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "155ccbd7-eaca-48cf-b28b-4409a7b5087d",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "de13439e-4c49-491e-8516-3437f67a816c",
              "type": "user_notification_rules"
            },
            {
              "id": "96b31b43-9037-47f8-a4db-6c9d2539faae",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1099",
      "type": "users",
      "attributes": {
        "name": "Stevie Hand",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Stevie",
        "last_name": "Hand",
        "full_name": "Stevie Hand",
        "full_name_with_team": "[Osinski, Kozey and Hintz] Stevie Hand",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-12T08:09:53.867-08:00",
        "created_at": "2026-02-12T08:09:53.867-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "34d3ec94-201b-419e-92d8-5f26dcf29e24",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e7c5f719-af19-4ff2-8b0d-ed08febd1505",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "155ccbd7-eaca-48cf-b28b-4409a7b5087d",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "342a1253-9bfb-4455-8908-903c78adf362",
              "type": "user_notification_rules"
            },
            {
              "id": "19f6bf7f-6110-4f1e-a9d9-3c28be49a9e7",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1098",
      "type": "users",
      "attributes": {
        "name": "Titus Williamson",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Titus",
        "last_name": "Williamson",
        "full_name": "Titus Williamson",
        "full_name_with_team": "[Osinski, Kozey and Hintz] Titus Williamson",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-12T08:09:53.707-08:00",
        "created_at": "2026-02-12T08:09:53.707-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "4677a867-9cdd-4c27-9716-6c361b4874a5",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b3373f8a-94c9-4eaa-8cbf-6301087c85bd",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "155ccbd7-eaca-48cf-b28b-4409a7b5087d",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "9f0bd4a3-1148-4de1-af16-d557f5f9554a",
              "type": "user_notification_rules"
            },
            {
              "id": "63ecbec8-f144-4f23-b58f-b95fb4f18168",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1096",
      "type": "users",
      "attributes": {
        "name": "Arvilla Haley",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Arvilla",
        "last_name": "Haley",
        "full_name": "Arvilla Haley",
        "full_name_with_team": "[Osinski, Kozey and Hintz] Arvilla Haley",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-12T08:09:53.142-08:00",
        "created_at": "2026-02-12T08:09:53.142-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "5b0dfdcf-061f-4c6e-bcc6-34091aebf806",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e7c5f719-af19-4ff2-8b0d-ed08febd1505",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "155ccbd7-eaca-48cf-b28b-4409a7b5087d",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "9bae900b-327c-4e11-859b-94aff706a639",
              "type": "user_notification_rules"
            },
            {
              "id": "ec78a779-06ab-454f-b40b-fdd43886caa3",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1095",
      "type": "users",
      "attributes": {
        "name": "Eugenio Corwin",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Eugenio",
        "last_name": "Corwin",
        "full_name": "Eugenio Corwin",
        "full_name_with_team": "[Osinski, Kozey and Hintz] Eugenio Corwin",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-12T08:09:52.983-08:00",
        "created_at": "2026-02-12T08:09:52.983-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "d362df71-8fc8-4dee-8f0a-72ccdd51214c",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e7c5f719-af19-4ff2-8b0d-ed08febd1505",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "155ccbd7-eaca-48cf-b28b-4409a7b5087d",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "2597590d-2123-4ab2-9a83-ac363693b729",
              "type": "user_notification_rules"
            },
            {
              "id": "ffcfa04e-912e-4a95-8c25-9d7b4bd857d3",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1094",
      "type": "users",
      "attributes": {
        "name": "Janita Larkin",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Janita",
        "last_name": "Larkin",
        "full_name": "Janita Larkin",
        "full_name_with_team": "[Osinski, Kozey and Hintz] Janita Larkin",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-12T08:09:52.871-08:00",
        "created_at": "2026-02-12T08:09:52.871-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "e5b51c17-336d-4844-9c45-35f516daeed6",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e7c5f719-af19-4ff2-8b0d-ed08febd1505",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "155ccbd7-eaca-48cf-b28b-4409a7b5087d",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "9e1b61d1-2741-47bd-8bf0-7e02db3f32fc",
              "type": "user_notification_rules"
            },
            {
              "id": "06c92442-94bb-4f13-9172-8587ef987125",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1093",
      "type": "users",
      "attributes": {
        "name": "Royce Sawayn",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Royce",
        "last_name": "Sawayn",
        "full_name": "Royce Sawayn",
        "full_name_with_team": "[Osinski, Kozey and Hintz] Royce Sawayn",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-12T08:09:52.768-08:00",
        "created_at": "2026-02-12T08:09:52.768-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "e18e53fc-b1b4-48a9-b164-7038bd44cf17",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e7c5f719-af19-4ff2-8b0d-ed08febd1505",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "155ccbd7-eaca-48cf-b28b-4409a7b5087d",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "5573eab7-a6db-4339-a557-fb9730369810",
              "type": "user_notification_rules"
            },
            {
              "id": "379de5dc-7502-4990-bf2a-f289d1ed473e",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1092",
      "type": "users",
      "attributes": {
        "name": "Irving Labadie",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Irving",
        "last_name": "Labadie",
        "full_name": "Irving Labadie",
        "full_name_with_team": "[Osinski, Kozey and Hintz] Irving Labadie",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-12T08:09:52.656-08:00",
        "created_at": "2026-02-12T08:09:52.656-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "12c0c8fb-7cd9-4869-84b4-144bafc7f693",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e7c5f719-af19-4ff2-8b0d-ed08febd1505",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "155ccbd7-eaca-48cf-b28b-4409a7b5087d",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "f98b0c88-eaf6-4f57-af5a-5bcc3b8fcf6d",
              "type": "user_notification_rules"
            },
            {
              "id": "92dc7e28-8869-496f-b423-528350afcd74",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1091",
      "type": "users",
      "attributes": {
        "name": "Anjanette Leuschke",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Anjanette",
        "last_name": "Leuschke",
        "full_name": "Anjanette Leuschke",
        "full_name_with_team": "[Osinski, Kozey and Hintz] Anjanette Leuschke",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-12T08:09:52.544-08:00",
        "created_at": "2026-02-12T08:09:52.544-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "2cd91ada-fd41-4fbd-b707-6a399dbd8b15",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e7c5f719-af19-4ff2-8b0d-ed08febd1505",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "155ccbd7-eaca-48cf-b28b-4409a7b5087d",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "100307a5-707f-40cd-af82-1d9817b9f96c",
              "type": "user_notification_rules"
            },
            {
              "id": "09cfa871-1845-4f89-8a59-b556217dc95a",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1090",
      "type": "users",
      "attributes": {
        "name": "Curt Ruecker",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Curt",
        "last_name": "Ruecker",
        "full_name": "Curt Ruecker",
        "full_name_with_team": "[Osinski, Kozey and Hintz] Curt Ruecker",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-12T08:09:52.433-08:00",
        "created_at": "2026-02-12T08:09:52.433-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "fea74164-d547-4b79-a6d0-1a5361b25c80",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e7c5f719-af19-4ff2-8b0d-ed08febd1505",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "155ccbd7-eaca-48cf-b28b-4409a7b5087d",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "a5b3b83b-f7ef-434e-a5eb-03a75cd00643",
              "type": "user_notification_rules"
            },
            {
              "id": "391bf193-95f1-4691-afa4-1a2866259beb",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1089",
      "type": "users",
      "attributes": {
        "name": "Merrilee Torphy",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Merrilee",
        "last_name": "Torphy",
        "full_name": "Merrilee Torphy",
        "full_name_with_team": "[Osinski, Kozey and Hintz] Merrilee Torphy",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-12T08:09:52.317-08:00",
        "created_at": "2026-02-12T08:09:52.317-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "99338070-5487-4a6a-9052-5ca795b01c70",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e7c5f719-af19-4ff2-8b0d-ed08febd1505",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "155ccbd7-eaca-48cf-b28b-4409a7b5087d",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "6b6cd8ff-f1f8-449b-95c4-05647d7d38ba",
              "type": "user_notification_rules"
            },
            {
              "id": "7c8033fe-d168-42a1-bec6-3e4f5a22f963",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1088",
      "type": "users",
      "attributes": {
        "name": "Thora Price",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Thora",
        "last_name": "Price",
        "full_name": "Thora Price",
        "full_name_with_team": "[Osinski, Kozey and Hintz] Thora Price",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-12T08:09:52.213-08:00",
        "created_at": "2026-02-12T08:09:52.213-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "95d1b9bd-675c-4fee-98e2-d4a58c09f257",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e7c5f719-af19-4ff2-8b0d-ed08febd1505",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "155ccbd7-eaca-48cf-b28b-4409a7b5087d",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "8102623b-d41a-4269-a935-fb7f96e7fd48",
              "type": "user_notification_rules"
            },
            {
              "id": "3b482b6b-5e26-4fd3-905b-9236a7045edc",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1087",
      "type": "users",
      "attributes": {
        "name": "Geoffrey Pacocha",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Geoffrey",
        "last_name": "Pacocha",
        "full_name": "Geoffrey Pacocha",
        "full_name_with_team": "[Osinski, Kozey and Hintz] Geoffrey Pacocha",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-12T08:09:52.207-08:00",
        "created_at": "2026-02-12T08:09:51.800-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "1def27f1-b5ac-4715-a490-edb0adcc512e",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b3373f8a-94c9-4eaa-8cbf-6301087c85bd",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "155ccbd7-eaca-48cf-b28b-4409a7b5087d",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "a90f7d8e-a01c-4779-9f5b-ee031cd5601e",
              "type": "user_notification_rules"
            },
            {
              "id": "8115280a-ec43-4bb3-b5e6-52d1d1d50eaa",
              "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