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": "961",
      "type": "users",
      "attributes": {
        "name": "Veola Reichel",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Veola",
        "last_name": "Reichel",
        "full_name": "Veola Reichel",
        "full_name_with_team": "[Yundt and Sons] Veola Reichel",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-13T10:41:54.782-08:00",
        "created_at": "2026-01-13T10:41:54.782-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "e5bab3e0-b104-4a30-8eb9-52d8f190b382",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "1b51c16a-b9bd-43bd-b0bc-cc69ff5b6e29",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "22166545-fe17-435d-87e1-318318c8aa60",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "ac177f74-f327-4381-8731-182de0a24f74",
              "type": "user_notification_rules"
            },
            {
              "id": "dd724dfe-cf59-48a3-b497-407978ec7553",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "960",
      "type": "users",
      "attributes": {
        "name": "Trenton Schinner",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Trenton",
        "last_name": "Schinner",
        "full_name": "Trenton Schinner",
        "full_name_with_team": "[Yundt and Sons] Trenton Schinner",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-13T10:41:54.700-08:00",
        "created_at": "2026-01-13T10:41:54.700-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "bdf6048c-9971-4312-9e5d-889a227ae4ca",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e7f1a3d1-19ed-4278-a8b5-3227de6edea6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "22166545-fe17-435d-87e1-318318c8aa60",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "878abf27-dc90-4441-8369-5dda55412d73",
              "type": "user_notification_rules"
            },
            {
              "id": "b0f11804-c86b-4974-8f1f-d7390aaf61c7",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "959",
      "type": "users",
      "attributes": {
        "name": "Jerrold Cole",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Jerrold",
        "last_name": "Cole",
        "full_name": "Jerrold Cole",
        "full_name_with_team": "[Yundt and Sons] Jerrold Cole",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-13T10:41:54.596-08:00",
        "created_at": "2026-01-13T10:41:54.596-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "f566ae6d-7f0e-4871-ba23-c0db4a8d2c77",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "f0d4ec81-b13e-41f0-b14e-a1e6c673c780",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "22166545-fe17-435d-87e1-318318c8aa60",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "a46d8ab0-6e87-485e-93ee-392ae59d0649",
              "type": "user_notification_rules"
            },
            {
              "id": "0f72026f-e842-49c7-816b-aa66f41bcfee",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "957",
      "type": "users",
      "attributes": {
        "name": "Stevie Balistreri",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Stevie",
        "last_name": "Balistreri",
        "full_name": "Stevie Balistreri",
        "full_name_with_team": "[Yundt and Sons] Stevie Balistreri",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-13T10:41:54.230-08:00",
        "created_at": "2026-01-13T10:41:54.230-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "2d0fb749-385a-4c66-91bc-cb582e7dcbca",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e7f1a3d1-19ed-4278-a8b5-3227de6edea6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "22166545-fe17-435d-87e1-318318c8aa60",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "9a5ca282-e7f1-4805-a6ea-ad2d0249c8ca",
              "type": "user_notification_rules"
            },
            {
              "id": "9880191e-a5a2-4fc2-9ed6-2e6a1a5942e2",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "956",
      "type": "users",
      "attributes": {
        "name": "Major Leffler",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Major",
        "last_name": "Leffler",
        "full_name": "Major Leffler",
        "full_name_with_team": "[Yundt and Sons] Major Leffler",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-13T10:41:54.149-08:00",
        "created_at": "2026-01-13T10:41:54.149-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "25e9fa1d-73e3-4689-b5e3-6185f0e6bc60",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e7f1a3d1-19ed-4278-a8b5-3227de6edea6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "22166545-fe17-435d-87e1-318318c8aa60",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "5ad2e912-8f52-4706-9b70-baf3784c5a19",
              "type": "user_notification_rules"
            },
            {
              "id": "34e67fcf-b651-4726-8519-97ccfb4b8ff5",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "955",
      "type": "users",
      "attributes": {
        "name": "Shad Mraz",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Shad",
        "last_name": "Mraz",
        "full_name": "Shad Mraz",
        "full_name_with_team": "[Yundt and Sons] Shad Mraz",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-13T10:41:54.071-08:00",
        "created_at": "2026-01-13T10:41:54.071-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "9d1a300c-6fbe-4a0f-9210-6913c8b0e6d2",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e7f1a3d1-19ed-4278-a8b5-3227de6edea6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "22166545-fe17-435d-87e1-318318c8aa60",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "f8d84a80-38fd-4049-bc67-917d63170763",
              "type": "user_notification_rules"
            },
            {
              "id": "d7f36f95-0b17-4969-92ef-a154931fbc7c",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "954",
      "type": "users",
      "attributes": {
        "name": "Marcella Borer",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Marcella",
        "last_name": "Borer",
        "full_name": "Marcella Borer",
        "full_name_with_team": "[Yundt and Sons] Marcella Borer",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-13T10:41:53.952-08:00",
        "created_at": "2026-01-13T10:41:53.952-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "311466e4-c8d4-48b4-ba62-d9e1c6809c93",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e7f1a3d1-19ed-4278-a8b5-3227de6edea6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "22166545-fe17-435d-87e1-318318c8aa60",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "1a05e3d5-1cdd-401a-b0de-f16619000450",
              "type": "user_notification_rules"
            },
            {
              "id": "96a72102-9826-4e92-a4d0-a58d7af62d63",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "953",
      "type": "users",
      "attributes": {
        "name": "Cathern Mueller",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Cathern",
        "last_name": "Mueller",
        "full_name": "Cathern Mueller",
        "full_name_with_team": "[Yundt and Sons] Cathern Mueller",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-13T10:41:53.875-08:00",
        "created_at": "2026-01-13T10:41:53.875-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "63e90dcb-7d92-4846-b3ea-b6c1b768fc85",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e7f1a3d1-19ed-4278-a8b5-3227de6edea6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "22166545-fe17-435d-87e1-318318c8aa60",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "b3fc95ce-4ef6-4fdc-90cb-33258236bf74",
              "type": "user_notification_rules"
            },
            {
              "id": "e33adea5-5c93-4f0c-b034-7c94451258b1",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "952",
      "type": "users",
      "attributes": {
        "name": "Salley Parker",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Salley",
        "last_name": "Parker",
        "full_name": "Salley Parker",
        "full_name_with_team": "[Yundt and Sons] Salley Parker",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-13T10:41:53.799-08:00",
        "created_at": "2026-01-13T10:41:53.799-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "00b703d8-e38b-4172-9cc0-4e4889f6c804",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e7f1a3d1-19ed-4278-a8b5-3227de6edea6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "22166545-fe17-435d-87e1-318318c8aa60",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "b106fd31-2c7d-4a7f-99ee-21fad435a698",
              "type": "user_notification_rules"
            },
            {
              "id": "62a33ab2-8bca-4d2d-9342-2cd17ea04a76",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "951",
      "type": "users",
      "attributes": {
        "name": "Julietta Gislason",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Julietta",
        "last_name": "Gislason",
        "full_name": "Julietta Gislason",
        "full_name_with_team": "[Yundt and Sons] Julietta Gislason",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-13T10:41:53.722-08:00",
        "created_at": "2026-01-13T10:41:53.722-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "04d23941-89c5-4fff-a079-caade3564b31",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e7f1a3d1-19ed-4278-a8b5-3227de6edea6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "22166545-fe17-435d-87e1-318318c8aa60",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "df0b19df-1e4c-4c00-b013-e7f913020882",
              "type": "user_notification_rules"
            },
            {
              "id": "4a074839-d6e2-44c1-9dc8-c2c0cfb6e82a",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "950",
      "type": "users",
      "attributes": {
        "name": "Sabrina Torp",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Sabrina",
        "last_name": "Torp",
        "full_name": "Sabrina Torp",
        "full_name_with_team": "[Yundt and Sons] Sabrina Torp",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-13T10:41:53.645-08:00",
        "created_at": "2026-01-13T10:41:53.645-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "06fc27c6-ab37-4640-bdf1-cbffeeebd24e",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e7f1a3d1-19ed-4278-a8b5-3227de6edea6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "22166545-fe17-435d-87e1-318318c8aa60",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "78cbaa32-6e84-4535-848f-c9f6a18a5691",
              "type": "user_notification_rules"
            },
            {
              "id": "90f3fd87-b9ef-4af6-ab58-287f7bc494c1",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "949",
      "type": "users",
      "attributes": {
        "name": "Hiram Wyman",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Hiram",
        "last_name": "Wyman",
        "full_name": "Hiram Wyman",
        "full_name_with_team": "[Yundt and Sons] Hiram Wyman",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-13T10:41:53.567-08:00",
        "created_at": "2026-01-13T10:41:53.567-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "c1fb89b9-22ba-41e8-8594-c4b1fbf50fdf",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e7f1a3d1-19ed-4278-a8b5-3227de6edea6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "22166545-fe17-435d-87e1-318318c8aa60",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "8717bb9f-1803-4c8b-834a-e6b07300ca9b",
              "type": "user_notification_rules"
            },
            {
              "id": "a96e0e7e-4d31-482e-88f3-eb573a39c0b9",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "948",
      "type": "users",
      "attributes": {
        "name": "Merri Hoeger",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Merri",
        "last_name": "Hoeger",
        "full_name": "Merri Hoeger",
        "full_name_with_team": "[Yundt and Sons] Merri Hoeger",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-13T10:41:53.563-08:00",
        "created_at": "2026-01-13T10:41:53.292-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "a016f84d-f335-469e-b943-184a2645ed94",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "f0d4ec81-b13e-41f0-b14e-a1e6c673c780",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "22166545-fe17-435d-87e1-318318c8aa60",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "b4abaa44-33be-460b-a9f8-df956835335b",
              "type": "user_notification_rules"
            },
            {
              "id": "6317a643-81eb-4ae6-af4d-fb372f7ae7e2",
              "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