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": "580",
      "type": "users",
      "attributes": {
        "name": "Dwayne Wilkinson",
        "email": "markus.doyle@gerlach.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Dwayne",
        "last_name": "Wilkinson",
        "full_name": "Dwayne Wilkinson",
        "full_name_with_team": "[Reynolds, Fisher and Jacobi] Dwayne Wilkinson",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-27T00:13:33.194-08:00",
        "created_at": "2025-11-27T00:13:33.194-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "d7571a97-c82f-4c96-b7ca-ba6c6be1b469",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "29bfa98c-2198-4c24-acb4-8cca29ffd96d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "f1b40244-121a-421f-ae60-660fa5060ffc",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "9c9bfe7f-185a-4b0e-b66f-01d43cbc7d14",
              "type": "user_notification_rules"
            },
            {
              "id": "5bc30cc2-a3e3-4790-b678-edf00d7925c9",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "579",
      "type": "users",
      "attributes": {
        "name": "Lane Larkin",
        "email": "miquel.emard@ondricka.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Lane",
        "last_name": "Larkin",
        "full_name": "Lane Larkin",
        "full_name_with_team": "[Reynolds, Fisher and Jacobi] Lane Larkin",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-27T00:13:33.005-08:00",
        "created_at": "2025-11-27T00:13:33.005-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "366c6771-5859-48a7-9fb7-45f94139b3aa",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "3f9cc95c-982c-4e3e-b6b2-1b86bb48e1a7",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "f1b40244-121a-421f-ae60-660fa5060ffc",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "9f664a73-7aa5-45ad-9efa-5ea7aeb3cc3d",
              "type": "user_notification_rules"
            },
            {
              "id": "c4b044e7-7be6-4281-a178-d509ad83ce51",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "578",
      "type": "users",
      "attributes": {
        "name": "Linh Gleichner",
        "email": "connie_casper@mante.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Linh",
        "last_name": "Gleichner",
        "full_name": "Linh Gleichner",
        "full_name_with_team": "[Reynolds, Fisher and Jacobi] Linh Gleichner",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-27T00:13:32.848-08:00",
        "created_at": "2025-11-27T00:13:32.848-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "fe02a78a-4998-474b-8448-766ada960bf8",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "198dbf2d-9794-431b-9eef-d33c04d4b7c6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "f1b40244-121a-421f-ae60-660fa5060ffc",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "1ece6a18-4319-4cd2-bb26-5c3d4305bad2",
              "type": "user_notification_rules"
            },
            {
              "id": "086ca75d-afc8-4190-a27d-50c2d65eb600",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "576",
      "type": "users",
      "attributes": {
        "name": "Pedro Cronin",
        "email": "magaly_pfannerstill@huel.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Pedro",
        "last_name": "Cronin",
        "full_name": "Pedro Cronin",
        "full_name_with_team": "[Reynolds, Fisher and Jacobi] Pedro Cronin",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-27T00:13:32.254-08:00",
        "created_at": "2025-11-27T00:13:32.254-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "06054dac-124e-4943-bd0b-95ad7782b3ab",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "3f9cc95c-982c-4e3e-b6b2-1b86bb48e1a7",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "f1b40244-121a-421f-ae60-660fa5060ffc",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "2a831e0b-6693-48fa-859c-bfc6e49a2551",
              "type": "user_notification_rules"
            },
            {
              "id": "f838ed11-91be-49fb-8da5-9f72bac6fdc8",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "575",
      "type": "users",
      "attributes": {
        "name": "Cheri West",
        "email": "zenobia@bergnaum.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Cheri",
        "last_name": "West",
        "full_name": "Cheri West",
        "full_name_with_team": "[Reynolds, Fisher and Jacobi] Cheri West",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-27T00:13:32.150-08:00",
        "created_at": "2025-11-27T00:13:32.150-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "9ff7a3ae-60c8-4a2e-a2ca-d2d5b4996c1a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "3f9cc95c-982c-4e3e-b6b2-1b86bb48e1a7",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "f1b40244-121a-421f-ae60-660fa5060ffc",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "a423b92e-8a0f-4b5b-834a-fd5ad4171285",
              "type": "user_notification_rules"
            },
            {
              "id": "2e259084-f3d7-4d41-abaa-bb6060b0b361",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "574",
      "type": "users",
      "attributes": {
        "name": "Antonio Kuhn",
        "email": "adina.stokes@kertzmann-rutherford.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Antonio",
        "last_name": "Kuhn",
        "full_name": "Antonio Kuhn",
        "full_name_with_team": "[Reynolds, Fisher and Jacobi] Antonio Kuhn",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-27T00:13:32.046-08:00",
        "created_at": "2025-11-27T00:13:32.046-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "f6ea08a4-369d-46a8-902d-abd59cfba6f8",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "3f9cc95c-982c-4e3e-b6b2-1b86bb48e1a7",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "f1b40244-121a-421f-ae60-660fa5060ffc",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "c0920da2-8cad-4573-9fb0-f3539e0ec721",
              "type": "user_notification_rules"
            },
            {
              "id": "212b9901-3461-4a04-8db8-6c2f8b29d26b",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "573",
      "type": "users",
      "attributes": {
        "name": "Mickey Buckridge",
        "email": "dannie@emard-kuhlman.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Mickey",
        "last_name": "Buckridge",
        "full_name": "Mickey Buckridge",
        "full_name_with_team": "[Reynolds, Fisher and Jacobi] Mickey Buckridge",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-27T00:13:31.940-08:00",
        "created_at": "2025-11-27T00:13:31.940-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "7bef8d80-ada0-46f2-9447-12b921398eb8",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "3f9cc95c-982c-4e3e-b6b2-1b86bb48e1a7",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "f1b40244-121a-421f-ae60-660fa5060ffc",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "ff6b5ed7-b1b0-4aeb-bf9c-bffda52fe65f",
              "type": "user_notification_rules"
            },
            {
              "id": "5c30f75b-ab3d-4cc7-8408-bb184bf73419",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "572",
      "type": "users",
      "attributes": {
        "name": "Margy Shanahan",
        "email": "davina@collins.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Margy",
        "last_name": "Shanahan",
        "full_name": "Margy Shanahan",
        "full_name_with_team": "[Reynolds, Fisher and Jacobi] Margy Shanahan",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-27T00:13:31.832-08:00",
        "created_at": "2025-11-27T00:13:31.832-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "dc2d7008-63fa-4d26-b408-5f4bf43619e5",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "3f9cc95c-982c-4e3e-b6b2-1b86bb48e1a7",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "f1b40244-121a-421f-ae60-660fa5060ffc",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "4f302b48-4856-4b96-a788-05cae9fbc370",
              "type": "user_notification_rules"
            },
            {
              "id": "09a095c9-1d22-4316-b563-0e9210890708",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "571",
      "type": "users",
      "attributes": {
        "name": "Lucius Pfannerstill",
        "email": "oscar.witting@schroeder.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Lucius",
        "last_name": "Pfannerstill",
        "full_name": "Lucius Pfannerstill",
        "full_name_with_team": "[Reynolds, Fisher and Jacobi] Lucius Pfannerstill",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-27T00:13:31.721-08:00",
        "created_at": "2025-11-27T00:13:31.721-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "eb63b49c-dedc-4b10-aa5c-9668fccf0a11",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "3f9cc95c-982c-4e3e-b6b2-1b86bb48e1a7",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "f1b40244-121a-421f-ae60-660fa5060ffc",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "dddfda23-0152-4bff-b6f5-cdb92d34f516",
              "type": "user_notification_rules"
            },
            {
              "id": "b9da85aa-4e17-4d16-a934-d326164a5451",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "570",
      "type": "users",
      "attributes": {
        "name": "Blondell Thompson",
        "email": "roy@kihn.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Blondell",
        "last_name": "Thompson",
        "full_name": "Blondell Thompson",
        "full_name_with_team": "[Reynolds, Fisher and Jacobi] Blondell Thompson",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-27T00:13:31.614-08:00",
        "created_at": "2025-11-27T00:13:31.614-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "b629717e-0d82-40c6-a82e-cbcbb6666d1f",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "3f9cc95c-982c-4e3e-b6b2-1b86bb48e1a7",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "f1b40244-121a-421f-ae60-660fa5060ffc",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "99d77b5f-37a3-44da-a1dc-3429c07c5bb0",
              "type": "user_notification_rules"
            },
            {
              "id": "03c7d17b-6364-49ab-a1b7-2eeeed1ac908",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "569",
      "type": "users",
      "attributes": {
        "name": "Willy Veum",
        "email": "joaquin@trantow.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Willy",
        "last_name": "Veum",
        "full_name": "Willy Veum",
        "full_name_with_team": "[Reynolds, Fisher and Jacobi] Willy Veum",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-27T00:13:31.508-08:00",
        "created_at": "2025-11-27T00:13:31.508-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "f3023ea7-3d9f-4763-8c1b-720f1de6deae",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "3f9cc95c-982c-4e3e-b6b2-1b86bb48e1a7",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "f1b40244-121a-421f-ae60-660fa5060ffc",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "8e36bfd8-888f-44dc-9bd7-0d7b8b75b0eb",
              "type": "user_notification_rules"
            },
            {
              "id": "75033f13-9faa-4be1-9feb-6af8e93f49a0",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "568",
      "type": "users",
      "attributes": {
        "name": "Van Kulas",
        "email": "dong@little.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Van",
        "last_name": "Kulas",
        "full_name": "Van Kulas",
        "full_name_with_team": "[Reynolds, Fisher and Jacobi] Van Kulas",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-27T00:13:31.400-08:00",
        "created_at": "2025-11-27T00:13:31.400-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "307db67f-c8a0-4f5c-8089-8449ca59c2c8",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "3f9cc95c-982c-4e3e-b6b2-1b86bb48e1a7",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "f1b40244-121a-421f-ae60-660fa5060ffc",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "3b7760f2-15af-430a-ab64-f3c5159b764e",
              "type": "user_notification_rules"
            },
            {
              "id": "40285f57-fe50-4291-b1e1-5745434fbe52",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "567",
      "type": "users",
      "attributes": {
        "name": "Johnathan Mayer",
        "email": "hortencia.wuckert@rice-jacobi.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Johnathan",
        "last_name": "Mayer",
        "full_name": "Johnathan Mayer",
        "full_name_with_team": "[Reynolds, Fisher and Jacobi] Johnathan Mayer",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-27T00:13:31.394-08:00",
        "created_at": "2025-11-27T00:13:30.949-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "6f4093ce-dca7-4d6f-bfad-1ca67afac2dd",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "198dbf2d-9794-431b-9eef-d33c04d4b7c6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "f1b40244-121a-421f-ae60-660fa5060ffc",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "40a40471-720b-4d87-b56a-53ceb8048499",
              "type": "user_notification_rules"
            },
            {
              "id": "2e024e97-0dc6-4f9b-83c7-7767bdd13281",
              "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