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": "Mirna Davis",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Mirna",
        "last_name": "Davis",
        "full_name": "Mirna Davis",
        "full_name_with_team": "[Batz and Sons] Mirna Davis",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-04T13:41:27.896-08:00",
        "created_at": "2026-02-04T13:41:27.896-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "30707d56-91f3-430f-8c6f-a05623f1e28d",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "2bd2d311-be1f-4bed-b99d-d958af318472",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "06d3ab57-881f-47f9-b2ca-f14f4497d00a",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "5c3e50d7-daa5-4033-814e-c60420284a00",
              "type": "user_notification_rules"
            },
            {
              "id": "a0ac6612-2617-41c7-af81-cf1be43ed6b6",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1071",
      "type": "users",
      "attributes": {
        "name": "Mao Casper",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Mao",
        "last_name": "Casper",
        "full_name": "Mao Casper",
        "full_name_with_team": "[Batz and Sons] Mao Casper",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-04T13:41:27.784-08:00",
        "created_at": "2026-02-04T13:41:27.784-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "227edbfe-57cb-4499-8790-8b94467c4801",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "100805a5-3e13-4ac0-b5d5-61aab0b573f0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "06d3ab57-881f-47f9-b2ca-f14f4497d00a",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "32488b45-1d24-4922-8503-166149bcd187",
              "type": "user_notification_rules"
            },
            {
              "id": "5f721c5b-7336-4ff2-9914-9d3a4bad6c13",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1070",
      "type": "users",
      "attributes": {
        "name": "Chasidy Braun",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Chasidy",
        "last_name": "Braun",
        "full_name": "Chasidy Braun",
        "full_name_with_team": "[Batz and Sons] Chasidy Braun",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-04T13:41:27.661-08:00",
        "created_at": "2026-02-04T13:41:27.661-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "dcd2e5c5-6e42-43bf-8b1a-bb0dd2262433",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e99b95c1-c534-4a84-b7e9-d2d091384723",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "06d3ab57-881f-47f9-b2ca-f14f4497d00a",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "56074d34-6e79-4c81-8323-5ec405599b86",
              "type": "user_notification_rules"
            },
            {
              "id": "7eb23535-9b90-439e-a85c-2e6caf2ec42d",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1068",
      "type": "users",
      "attributes": {
        "name": "Dara Botsford",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Dara",
        "last_name": "Botsford",
        "full_name": "Dara Botsford",
        "full_name_with_team": "[Batz and Sons] Dara Botsford",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-04T13:41:27.252-08:00",
        "created_at": "2026-02-04T13:41:27.252-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "5a947696-8038-459e-ab16-6a3e34ec0605",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "100805a5-3e13-4ac0-b5d5-61aab0b573f0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "06d3ab57-881f-47f9-b2ca-f14f4497d00a",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "24275ad9-d826-453a-b271-146fe940d41a",
              "type": "user_notification_rules"
            },
            {
              "id": "f731b4b2-439c-4e2a-802b-4c47125c7d8d",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1067",
      "type": "users",
      "attributes": {
        "name": "January Doyle",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "January",
        "last_name": "Doyle",
        "full_name": "January Doyle",
        "full_name_with_team": "[Batz and Sons] January Doyle",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-04T13:41:27.115-08:00",
        "created_at": "2026-02-04T13:41:27.115-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "bfc93d53-566d-4dc9-8176-a41dd46a4a9f",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "100805a5-3e13-4ac0-b5d5-61aab0b573f0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "06d3ab57-881f-47f9-b2ca-f14f4497d00a",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "afe4c9bf-0b6a-4eff-8332-814567aa56ba",
              "type": "user_notification_rules"
            },
            {
              "id": "b09ae2e6-94ff-4145-bae0-a73fdc325d52",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1066",
      "type": "users",
      "attributes": {
        "name": "Nathanael Brakus",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Nathanael",
        "last_name": "Brakus",
        "full_name": "Nathanael Brakus",
        "full_name_with_team": "[Batz and Sons] Nathanael Brakus",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-04T13:41:27.023-08:00",
        "created_at": "2026-02-04T13:41:27.023-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "9156db45-bbd8-4b7d-9ead-e4d476727145",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "100805a5-3e13-4ac0-b5d5-61aab0b573f0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "06d3ab57-881f-47f9-b2ca-f14f4497d00a",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "e4152094-2174-4079-a3a7-a633bb75a6d0",
              "type": "user_notification_rules"
            },
            {
              "id": "d0d30d59-1764-47b7-9b35-c71fc7d03523",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1065",
      "type": "users",
      "attributes": {
        "name": "Murray Wisozk",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Murray",
        "last_name": "Wisozk",
        "full_name": "Murray Wisozk",
        "full_name_with_team": "[Batz and Sons] Murray Wisozk",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-04T13:41:26.928-08:00",
        "created_at": "2026-02-04T13:41:26.928-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "0c841f0a-0917-4c3a-be86-3602c961753a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "100805a5-3e13-4ac0-b5d5-61aab0b573f0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "06d3ab57-881f-47f9-b2ca-f14f4497d00a",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "a8839e65-07f1-4fcb-94f8-6a21371d6430",
              "type": "user_notification_rules"
            },
            {
              "id": "95f514cf-c06b-4fd1-ada6-b7153790879f",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1064",
      "type": "users",
      "attributes": {
        "name": "Delana Stehr",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Delana",
        "last_name": "Stehr",
        "full_name": "Delana Stehr",
        "full_name_with_team": "[Batz and Sons] Delana Stehr",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-04T13:41:26.832-08:00",
        "created_at": "2026-02-04T13:41:26.832-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "3d321b70-1fdc-4346-b297-c21eb9fc17d6",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "100805a5-3e13-4ac0-b5d5-61aab0b573f0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "06d3ab57-881f-47f9-b2ca-f14f4497d00a",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "9c3efece-3323-4e10-a196-74d65a8d0d3d",
              "type": "user_notification_rules"
            },
            {
              "id": "e405bc44-8995-43dc-b217-36a7e7a00f75",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1063",
      "type": "users",
      "attributes": {
        "name": "Consuela Jacobs",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Consuela",
        "last_name": "Jacobs",
        "full_name": "Consuela Jacobs",
        "full_name_with_team": "[Batz and Sons] Consuela Jacobs",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-04T13:41:26.754-08:00",
        "created_at": "2026-02-04T13:41:26.754-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "394d819a-f548-4802-9088-a9f6289c8aae",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "100805a5-3e13-4ac0-b5d5-61aab0b573f0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "06d3ab57-881f-47f9-b2ca-f14f4497d00a",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "ffad430d-e45e-45d1-83a5-44446a661a7c",
              "type": "user_notification_rules"
            },
            {
              "id": "b5e1d7a8-8324-4c5b-914a-ff3f601be259",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1062",
      "type": "users",
      "attributes": {
        "name": "Ward Botsford",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Ward",
        "last_name": "Botsford",
        "full_name": "Ward Botsford",
        "full_name_with_team": "[Batz and Sons] Ward Botsford",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-04T13:41:26.676-08:00",
        "created_at": "2026-02-04T13:41:26.676-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "7dc642fd-9832-49e0-acc3-c2e861143d89",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "100805a5-3e13-4ac0-b5d5-61aab0b573f0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "06d3ab57-881f-47f9-b2ca-f14f4497d00a",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "26344e4e-819c-4a65-9d8f-b861cbf76726",
              "type": "user_notification_rules"
            },
            {
              "id": "1efb4b95-df89-4241-9744-51108abe49c1",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1061",
      "type": "users",
      "attributes": {
        "name": "Paul Sawayn",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Paul",
        "last_name": "Sawayn",
        "full_name": "Paul Sawayn",
        "full_name_with_team": "[Batz and Sons] Paul Sawayn",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-04T13:41:26.568-08:00",
        "created_at": "2026-02-04T13:41:26.567-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "34ab417d-933e-495a-825a-a4d814b73259",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "100805a5-3e13-4ac0-b5d5-61aab0b573f0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "06d3ab57-881f-47f9-b2ca-f14f4497d00a",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "f30ecba2-7d16-4508-8260-d05617660507",
              "type": "user_notification_rules"
            },
            {
              "id": "eaf160f5-63c3-4478-a4ac-0e2ac2db37b8",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1060",
      "type": "users",
      "attributes": {
        "name": "Elidia Feest",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Elidia",
        "last_name": "Feest",
        "full_name": "Elidia Feest",
        "full_name_with_team": "[Batz and Sons] Elidia Feest",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-04T13:41:26.472-08:00",
        "created_at": "2026-02-04T13:41:26.472-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "0b616b28-d7cb-4a38-8d7e-d1271faabea2",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "100805a5-3e13-4ac0-b5d5-61aab0b573f0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "06d3ab57-881f-47f9-b2ca-f14f4497d00a",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "f5147605-687e-44f0-8c81-701aeb06b7f9",
              "type": "user_notification_rules"
            },
            {
              "id": "44df4dfc-ddfa-49fc-8bbe-b44f9e7a11d4",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1059",
      "type": "users",
      "attributes": {
        "name": "Saul Jaskolski",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Saul",
        "last_name": "Jaskolski",
        "full_name": "Saul Jaskolski",
        "full_name_with_team": "[Batz and Sons] Saul Jaskolski",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-04T13:41:26.467-08:00",
        "created_at": "2026-02-04T13:41:26.127-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "3ae803f5-3e73-4c9e-9dba-58e10d84729b",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e99b95c1-c534-4a84-b7e9-d2d091384723",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "06d3ab57-881f-47f9-b2ca-f14f4497d00a",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "c0221a15-cd70-4e25-9c84-3f856b124a48",
              "type": "user_notification_rules"
            },
            {
              "id": "fac94c5b-0fb5-468c-ac31-6ea8ec3515a6",
              "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