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": "1072",
      "type": "users",
      "attributes": {
        "name": "Terrell Roberts",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Terrell",
        "last_name": "Roberts",
        "full_name": "Terrell Roberts",
        "full_name_with_team": "[Durgan, Hodkiewicz and Crooks] Terrell Roberts",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-02T00:11:40.130-08:00",
        "created_at": "2026-02-02T00:11:40.130-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "f20f8577-4e18-4e2f-b934-542e10f9c826",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "a5294864-8cb4-457d-a9a3-d81d8ecd9a17",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "953bcb17-eb19-4a00-be73-dfdc37fdb04c",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "62a36f1d-e672-46c0-8782-5fdd50292832",
              "type": "user_notification_rules"
            },
            {
              "id": "5c0b32f0-0655-4ac3-8ab0-df8f39da0952",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1071",
      "type": "users",
      "attributes": {
        "name": "Issac Kohler",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Issac",
        "last_name": "Kohler",
        "full_name": "Issac Kohler",
        "full_name_with_team": "[Durgan, Hodkiewicz and Crooks] Issac Kohler",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-02T00:11:40.025-08:00",
        "created_at": "2026-02-02T00:11:40.025-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "11084727-a84f-4a1b-8f28-ea7dc1be2366",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e1f41374-7120-476d-9dd7-2de821dc513a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "953bcb17-eb19-4a00-be73-dfdc37fdb04c",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "bc945108-c0aa-4bae-bf80-17b68be54c77",
              "type": "user_notification_rules"
            },
            {
              "id": "28cbbf15-a684-4256-a1ac-1b409447c240",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1070",
      "type": "users",
      "attributes": {
        "name": "Echo Block",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Echo",
        "last_name": "Block",
        "full_name": "Echo Block",
        "full_name_with_team": "[Durgan, Hodkiewicz and Crooks] Echo Block",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-02T00:11:39.894-08:00",
        "created_at": "2026-02-02T00:11:39.894-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "4ece82ca-9c11-4282-a3e8-2030321b35f6",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "61c20e48-82d1-4e95-bb75-75ca9b05f84d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "953bcb17-eb19-4a00-be73-dfdc37fdb04c",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "4667e0e5-cc8e-4bdd-a427-cac2835f6fd2",
              "type": "user_notification_rules"
            },
            {
              "id": "cc5a1139-cd56-4dfe-89ad-1782ab36e7ca",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1068",
      "type": "users",
      "attributes": {
        "name": "Jenni Schmitt",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Jenni",
        "last_name": "Schmitt",
        "full_name": "Jenni Schmitt",
        "full_name_with_team": "[Durgan, Hodkiewicz and Crooks] Jenni Schmitt",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-02T00:11:39.444-08:00",
        "created_at": "2026-02-02T00:11:39.444-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "e8e34d10-4144-48aa-a4b0-77cadaab7b18",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e1f41374-7120-476d-9dd7-2de821dc513a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "953bcb17-eb19-4a00-be73-dfdc37fdb04c",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "d742793e-9326-4f7e-82ab-c386a7e8b379",
              "type": "user_notification_rules"
            },
            {
              "id": "4f9d7795-d3b5-451e-8823-f962d6a981bf",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1067",
      "type": "users",
      "attributes": {
        "name": "Elizbeth Kilback",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Elizbeth",
        "last_name": "Kilback",
        "full_name": "Elizbeth Kilback",
        "full_name_with_team": "[Durgan, Hodkiewicz and Crooks] Elizbeth Kilback",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-02T00:11:39.353-08:00",
        "created_at": "2026-02-02T00:11:39.353-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "fa683fbd-cc66-4486-b2b5-1b54730ad959",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e1f41374-7120-476d-9dd7-2de821dc513a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "953bcb17-eb19-4a00-be73-dfdc37fdb04c",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "11c8d06b-f7d5-419b-824d-00213ebd4259",
              "type": "user_notification_rules"
            },
            {
              "id": "e98dc481-cdf9-4771-8f1c-f3a6ef7f8064",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1066",
      "type": "users",
      "attributes": {
        "name": "Rodney Upton",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Rodney",
        "last_name": "Upton",
        "full_name": "Rodney Upton",
        "full_name_with_team": "[Durgan, Hodkiewicz and Crooks] Rodney Upton",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-02T00:11:39.262-08:00",
        "created_at": "2026-02-02T00:11:39.262-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "284fd522-7666-4b6d-b8e0-e4a177b5048c",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e1f41374-7120-476d-9dd7-2de821dc513a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "953bcb17-eb19-4a00-be73-dfdc37fdb04c",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "80eba2eb-36c0-4f3c-9c22-3714b14aafb0",
              "type": "user_notification_rules"
            },
            {
              "id": "210a6069-b735-457f-98a8-76a9c6aae22b",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1065",
      "type": "users",
      "attributes": {
        "name": "Evan Kutch",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Evan",
        "last_name": "Kutch",
        "full_name": "Evan Kutch",
        "full_name_with_team": "[Durgan, Hodkiewicz and Crooks] Evan Kutch",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-02T00:11:39.172-08:00",
        "created_at": "2026-02-02T00:11:39.172-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "30c618b7-adfe-443e-ab94-4d2d6598ef10",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e1f41374-7120-476d-9dd7-2de821dc513a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "953bcb17-eb19-4a00-be73-dfdc37fdb04c",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "5a9b0d53-a0be-4a3b-8aa9-027485681cdb",
              "type": "user_notification_rules"
            },
            {
              "id": "3fe8651e-17f3-4a4b-963a-826665dba44f",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1064",
      "type": "users",
      "attributes": {
        "name": "Terina Bartoletti",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Terina",
        "last_name": "Bartoletti",
        "full_name": "Terina Bartoletti",
        "full_name_with_team": "[Durgan, Hodkiewicz and Crooks] Terina Bartoletti",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-02T00:11:39.078-08:00",
        "created_at": "2026-02-02T00:11:39.078-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "6ff06ee4-11e4-45f9-8e4c-149f25bf8817",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e1f41374-7120-476d-9dd7-2de821dc513a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "953bcb17-eb19-4a00-be73-dfdc37fdb04c",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "f35b682e-3aa5-481d-9287-4df041444b02",
              "type": "user_notification_rules"
            },
            {
              "id": "4cca4d94-aec2-4c72-8fff-d99c951a9a41",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1063",
      "type": "users",
      "attributes": {
        "name": "Tameka Rempel",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Tameka",
        "last_name": "Rempel",
        "full_name": "Tameka Rempel",
        "full_name_with_team": "[Durgan, Hodkiewicz and Crooks] Tameka Rempel",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-02T00:11:38.986-08:00",
        "created_at": "2026-02-02T00:11:38.986-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "856e7b3e-a45a-4b37-9f6f-1e5dfb5e84e2",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e1f41374-7120-476d-9dd7-2de821dc513a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "953bcb17-eb19-4a00-be73-dfdc37fdb04c",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "36e6c5aa-f033-4f7c-9021-c9eeb55c0883",
              "type": "user_notification_rules"
            },
            {
              "id": "3cb423ad-841c-467a-8ff4-d50aec4522af",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1062",
      "type": "users",
      "attributes": {
        "name": "Glenn Schaden",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Glenn",
        "last_name": "Schaden",
        "full_name": "Glenn Schaden",
        "full_name_with_team": "[Durgan, Hodkiewicz and Crooks] Glenn Schaden",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-02T00:11:38.893-08:00",
        "created_at": "2026-02-02T00:11:38.893-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "28a5df97-590a-454d-af4a-034c98f54bc2",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e1f41374-7120-476d-9dd7-2de821dc513a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "953bcb17-eb19-4a00-be73-dfdc37fdb04c",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "ec31d800-4c61-46da-9dec-dbb7804d398b",
              "type": "user_notification_rules"
            },
            {
              "id": "099378d5-5537-4fc3-81c8-82362b4b9572",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1061",
      "type": "users",
      "attributes": {
        "name": "Levi Hagenes",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Levi",
        "last_name": "Hagenes",
        "full_name": "Levi Hagenes",
        "full_name_with_team": "[Durgan, Hodkiewicz and Crooks] Levi Hagenes",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-02T00:11:38.801-08:00",
        "created_at": "2026-02-02T00:11:38.801-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "81f2248b-55d8-4512-b3ae-b06001ad0446",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e1f41374-7120-476d-9dd7-2de821dc513a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "953bcb17-eb19-4a00-be73-dfdc37fdb04c",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "8876e6f5-7fee-4810-bdd1-1dd6148534d9",
              "type": "user_notification_rules"
            },
            {
              "id": "7b9f82c7-aed2-4b5d-bea4-4aa475ad9d0a",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1060",
      "type": "users",
      "attributes": {
        "name": "Don Monahan",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Don",
        "last_name": "Monahan",
        "full_name": "Don Monahan",
        "full_name_with_team": "[Durgan, Hodkiewicz and Crooks] Don Monahan",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-02T00:11:38.702-08:00",
        "created_at": "2026-02-02T00:11:38.702-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "1128209f-8ad7-47a0-9fbd-0ae61f6e16b1",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e1f41374-7120-476d-9dd7-2de821dc513a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "953bcb17-eb19-4a00-be73-dfdc37fdb04c",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "d0de2e95-304c-45b1-9121-ac89377f9d5c",
              "type": "user_notification_rules"
            },
            {
              "id": "833289d5-943c-42b0-a0c5-080bfa3268db",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1059",
      "type": "users",
      "attributes": {
        "name": "Raymond Kassulke",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Raymond",
        "last_name": "Kassulke",
        "full_name": "Raymond Kassulke",
        "full_name_with_team": "[Durgan, Hodkiewicz and Crooks] Raymond Kassulke",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-02T00:11:38.697-08:00",
        "created_at": "2026-02-02T00:11:38.306-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "7ba0e5f2-711e-48eb-8f58-824e30e0435a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "61c20e48-82d1-4e95-bb75-75ca9b05f84d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "953bcb17-eb19-4a00-be73-dfdc37fdb04c",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "9fc163e5-013e-434d-adb9-fecf54173151",
              "type": "user_notification_rules"
            },
            {
              "id": "0cc71459-86a4-4afb-b1ce-e4972dfb9156",
              "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[search]
string
​
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
​
links
object
required
​
meta
object
required