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": "Selma Stanton",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Selma",
        "last_name": "Stanton",
        "full_name": "Selma Stanton",
        "full_name_with_team": "[Reichel Group] Selma Stanton",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-31T09:20:29.249-08:00",
        "created_at": "2026-01-31T09:20:29.249-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "e22a6e38-31b1-4b0a-bb2a-e5739ee36b14",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d8549ac2-5ba8-4771-b0d6-39a384eabe88",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7975ff96-9592-41bf-b5f8-0de472d66e9b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "1e7dfbd8-088f-413a-a5c2-fb6ea99b3ca7",
              "type": "user_notification_rules"
            },
            {
              "id": "292d19df-90e0-459c-ad07-90ba9386dade",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1071",
      "type": "users",
      "attributes": {
        "name": "Jenice Johnson",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Jenice",
        "last_name": "Johnson",
        "full_name": "Jenice Johnson",
        "full_name_with_team": "[Reichel Group] Jenice Johnson",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-31T09:20:29.173-08:00",
        "created_at": "2026-01-31T09:20:29.173-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "019d2c6e-1196-4077-9db9-7d6fd35943ab",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "be1e1786-9757-4a0e-ab31-52db4477b06d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7975ff96-9592-41bf-b5f8-0de472d66e9b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "af3b1ceb-484a-4dd7-9e40-8a860e817856",
              "type": "user_notification_rules"
            },
            {
              "id": "12117c5b-37dd-4e88-aeaa-3a7ab6f7496c",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1070",
      "type": "users",
      "attributes": {
        "name": "Giuseppe O'Conner",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Giuseppe",
        "last_name": "O'Conner",
        "full_name": "Giuseppe O'Conner",
        "full_name_with_team": "[Reichel Group] Giuseppe O'Conner",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-31T09:20:29.067-08:00",
        "created_at": "2026-01-31T09:20:29.067-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "22dc12ae-f3ab-466b-b63f-e1735cd60426",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c06d1263-5f0f-4565-ae0e-bfe113ad5c9c",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7975ff96-9592-41bf-b5f8-0de472d66e9b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "631513fe-fbce-4de9-8cc4-531e6fab53a9",
              "type": "user_notification_rules"
            },
            {
              "id": "4ef35f1a-7dae-4d16-aa6c-acf8777d1776",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1068",
      "type": "users",
      "attributes": {
        "name": "Suk Armstrong",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Suk",
        "last_name": "Armstrong",
        "full_name": "Suk Armstrong",
        "full_name_with_team": "[Reichel Group] Suk Armstrong",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-31T09:20:28.706-08:00",
        "created_at": "2026-01-31T09:20:28.706-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "56e0026b-340e-409b-9b12-9834114d9be5",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "be1e1786-9757-4a0e-ab31-52db4477b06d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7975ff96-9592-41bf-b5f8-0de472d66e9b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "e97ab0dd-38c6-42c4-93f6-e6dc2e4ebd3b",
              "type": "user_notification_rules"
            },
            {
              "id": "9542eafd-365e-47b8-8f59-ca6f4219d064",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1067",
      "type": "users",
      "attributes": {
        "name": "Caren Howe",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Caren",
        "last_name": "Howe",
        "full_name": "Caren Howe",
        "full_name_with_team": "[Reichel Group] Caren Howe",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-31T09:20:28.631-08:00",
        "created_at": "2026-01-31T09:20:28.631-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "7737d118-e2b5-4a81-801e-8d2c0ff4ebf8",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "be1e1786-9757-4a0e-ab31-52db4477b06d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7975ff96-9592-41bf-b5f8-0de472d66e9b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "c63b50a6-df4b-44c4-92be-be81abfea2e3",
              "type": "user_notification_rules"
            },
            {
              "id": "33604ae2-7794-442c-98d8-fb4c059a1b11",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1066",
      "type": "users",
      "attributes": {
        "name": "Wilburn Grant",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Wilburn",
        "last_name": "Grant",
        "full_name": "Wilburn Grant",
        "full_name_with_team": "[Reichel Group] Wilburn Grant",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-31T09:20:28.556-08:00",
        "created_at": "2026-01-31T09:20:28.556-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "1456884b-021f-49a7-b6aa-e84b54062044",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "be1e1786-9757-4a0e-ab31-52db4477b06d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7975ff96-9592-41bf-b5f8-0de472d66e9b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "9081cbcd-02a8-44e2-b191-88a1285e34b1",
              "type": "user_notification_rules"
            },
            {
              "id": "97fb4155-c7fc-4f82-ac5b-7921011deb42",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1065",
      "type": "users",
      "attributes": {
        "name": "Madalene Beer",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Madalene",
        "last_name": "Beer",
        "full_name": "Madalene Beer",
        "full_name_with_team": "[Reichel Group] Madalene Beer",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-31T09:20:28.479-08:00",
        "created_at": "2026-01-31T09:20:28.479-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "db64ea27-7459-48de-bf71-72f46b02cc23",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "be1e1786-9757-4a0e-ab31-52db4477b06d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7975ff96-9592-41bf-b5f8-0de472d66e9b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "db07a29c-c531-4f00-af58-3c29b89789f2",
              "type": "user_notification_rules"
            },
            {
              "id": "ba71b9c9-29ae-4de9-aace-e78ea99373ea",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1064",
      "type": "users",
      "attributes": {
        "name": "Carlton Ferry",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Carlton",
        "last_name": "Ferry",
        "full_name": "Carlton Ferry",
        "full_name_with_team": "[Reichel Group] Carlton Ferry",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-31T09:20:28.413-08:00",
        "created_at": "2026-01-31T09:20:28.413-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "33dd783c-ee21-4e4f-8506-30345f28f9cc",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "be1e1786-9757-4a0e-ab31-52db4477b06d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7975ff96-9592-41bf-b5f8-0de472d66e9b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "c46d82b2-db62-4ef7-b372-44ff018f59f9",
              "type": "user_notification_rules"
            },
            {
              "id": "2d90669f-872d-4254-8dde-7804f71f1321",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1063",
      "type": "users",
      "attributes": {
        "name": "Marylyn Mosciski",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Marylyn",
        "last_name": "Mosciski",
        "full_name": "Marylyn Mosciski",
        "full_name_with_team": "[Reichel Group] Marylyn Mosciski",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-31T09:20:28.336-08:00",
        "created_at": "2026-01-31T09:20:28.336-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "47aabf3f-4e3d-434c-bd6f-be839c1d5e5b",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "be1e1786-9757-4a0e-ab31-52db4477b06d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7975ff96-9592-41bf-b5f8-0de472d66e9b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "992e806a-e7e1-46b5-b3ea-b6aed0b69cd3",
              "type": "user_notification_rules"
            },
            {
              "id": "43cd1dcc-05e6-455e-b6a8-6bc1e1d5255a",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1062",
      "type": "users",
      "attributes": {
        "name": "Krystin Labadie",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Krystin",
        "last_name": "Labadie",
        "full_name": "Krystin Labadie",
        "full_name_with_team": "[Reichel Group] Krystin Labadie",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-31T09:20:28.258-08:00",
        "created_at": "2026-01-31T09:20:28.258-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "b1f615ce-6376-49be-b678-120ec92b1f41",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "be1e1786-9757-4a0e-ab31-52db4477b06d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7975ff96-9592-41bf-b5f8-0de472d66e9b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "1d0a49c2-cab9-44e7-a05b-59c4e5b2a5e8",
              "type": "user_notification_rules"
            },
            {
              "id": "1a91441e-9645-4ac0-80c7-70a326298936",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1061",
      "type": "users",
      "attributes": {
        "name": "Savanna Gulgowski",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Savanna",
        "last_name": "Gulgowski",
        "full_name": "Savanna Gulgowski",
        "full_name_with_team": "[Reichel Group] Savanna Gulgowski",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-31T09:20:28.180-08:00",
        "created_at": "2026-01-31T09:20:28.180-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "8bbba16f-c827-471d-b988-b2058c7f2199",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "be1e1786-9757-4a0e-ab31-52db4477b06d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7975ff96-9592-41bf-b5f8-0de472d66e9b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "1bf6c54b-5af4-4fdc-a630-78d26753e3db",
              "type": "user_notification_rules"
            },
            {
              "id": "5f643f65-4057-4712-9b66-cefa5708e359",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1060",
      "type": "users",
      "attributes": {
        "name": "Cruz Marvin",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Cruz",
        "last_name": "Marvin",
        "full_name": "Cruz Marvin",
        "full_name_with_team": "[Reichel Group] Cruz Marvin",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-31T09:20:28.102-08:00",
        "created_at": "2026-01-31T09:20:28.102-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "0c0098fb-9765-4582-960d-c340a6ed57c2",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "be1e1786-9757-4a0e-ab31-52db4477b06d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7975ff96-9592-41bf-b5f8-0de472d66e9b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "e367b152-10e9-46a0-8d0a-439981a27ec9",
              "type": "user_notification_rules"
            },
            {
              "id": "b8e656ad-b00b-4620-842a-cc6f2f2b838f",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1059",
      "type": "users",
      "attributes": {
        "name": "Miguel Altenwerth",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Miguel",
        "last_name": "Altenwerth",
        "full_name": "Miguel Altenwerth",
        "full_name_with_team": "[Reichel Group] Miguel Altenwerth",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-31T09:20:28.096-08:00",
        "created_at": "2026-01-31T09:20:27.794-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "dfa6f2a8-018b-489d-bef9-03015223c0fa",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c06d1263-5f0f-4565-ae0e-bfe113ad5c9c",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7975ff96-9592-41bf-b5f8-0de472d66e9b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "46a5670a-dc51-4322-8d0e-f4bcfecf1ece",
              "type": "user_notification_rules"
            },
            {
              "id": "b4061e62-f222-4984-b293-56de0d33e378",
              "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