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": "982",
      "type": "users",
      "attributes": {
        "name": "Diego Bruen",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Diego",
        "last_name": "Bruen",
        "full_name": "Diego Bruen",
        "full_name_with_team": "[Lynch-Kertzmann] Diego Bruen",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T12:45:04.721-08:00",
        "created_at": "2026-01-16T12:45:04.721-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "466fdea3-9a85-4640-b939-4e32620e543c",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "dbdca445-f9f1-4570-9186-cb8c9d2661c0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "c99de617-aac5-45c7-8b68-757a4387d28e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "eff87db5-62e6-48d7-971f-42408142c808",
              "type": "user_notification_rules"
            },
            {
              "id": "d637f44c-b9bd-4919-ad81-04cf77dfd119",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "981",
      "type": "users",
      "attributes": {
        "name": "Blake Marvin",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Blake",
        "last_name": "Marvin",
        "full_name": "Blake Marvin",
        "full_name_with_team": "[Lynch-Kertzmann] Blake Marvin",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T12:45:04.617-08:00",
        "created_at": "2026-01-16T12:45:04.617-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "472ac1f3-865f-43c5-b1e3-f11fdf4c73a6",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "9debd720-f412-40a3-a75e-43c90638c92c",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "c99de617-aac5-45c7-8b68-757a4387d28e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "07751b73-02de-4004-a243-9a54cd601d6e",
              "type": "user_notification_rules"
            },
            {
              "id": "ae4792eb-30d8-4569-9a2e-1f9b6baf8031",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "980",
      "type": "users",
      "attributes": {
        "name": "Freeman Gutkowski",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Freeman",
        "last_name": "Gutkowski",
        "full_name": "Freeman Gutkowski",
        "full_name_with_team": "[Lynch-Kertzmann] Freeman Gutkowski",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T12:45:04.494-08:00",
        "created_at": "2026-01-16T12:45:04.494-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "d7b8ef3f-d17b-45a2-9550-8116d9113354",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "cc233747-722b-4885-948d-25c51bdb679b",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "c99de617-aac5-45c7-8b68-757a4387d28e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "2a816a2b-da77-462e-9541-5211abf3e95e",
              "type": "user_notification_rules"
            },
            {
              "id": "7a19fa35-b773-4357-b618-1849267eded3",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "978",
      "type": "users",
      "attributes": {
        "name": "Sid Kris",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Sid",
        "last_name": "Kris",
        "full_name": "Sid Kris",
        "full_name_with_team": "[Lynch-Kertzmann] Sid Kris",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T12:45:04.057-08:00",
        "created_at": "2026-01-16T12:45:04.057-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "c3a4ce87-0f10-4125-93a8-09ebcbe2dc41",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "9debd720-f412-40a3-a75e-43c90638c92c",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "c99de617-aac5-45c7-8b68-757a4387d28e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "14753689-b7e4-4b28-ae1b-3e01a3d01a9d",
              "type": "user_notification_rules"
            },
            {
              "id": "62500ab7-94ea-458e-bbf0-e62b5c44af03",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "977",
      "type": "users",
      "attributes": {
        "name": "Lenora Howell",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Lenora",
        "last_name": "Howell",
        "full_name": "Lenora Howell",
        "full_name_with_team": "[Lynch-Kertzmann] Lenora Howell",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T12:45:03.976-08:00",
        "created_at": "2026-01-16T12:45:03.976-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "63040496-b088-41c8-b37d-c7ddd91ca162",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "9debd720-f412-40a3-a75e-43c90638c92c",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "c99de617-aac5-45c7-8b68-757a4387d28e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "562b5eb4-13f8-47cc-8640-235fc0279583",
              "type": "user_notification_rules"
            },
            {
              "id": "da69cf5f-4168-4c01-a4a7-8590d03d1c84",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "976",
      "type": "users",
      "attributes": {
        "name": "Daniele Reynolds",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Daniele",
        "last_name": "Reynolds",
        "full_name": "Daniele Reynolds",
        "full_name_with_team": "[Lynch-Kertzmann] Daniele Reynolds",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T12:45:03.900-08:00",
        "created_at": "2026-01-16T12:45:03.900-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "c480cf70-e245-42f9-98ab-788212e5b674",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "9debd720-f412-40a3-a75e-43c90638c92c",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "c99de617-aac5-45c7-8b68-757a4387d28e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "e43d50bc-99e9-41d6-94e5-dbb2ea0e965c",
              "type": "user_notification_rules"
            },
            {
              "id": "b5ead785-6975-4a70-9aa5-e648c50f31e1",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "975",
      "type": "users",
      "attributes": {
        "name": "Quinn Thiel",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Quinn",
        "last_name": "Thiel",
        "full_name": "Quinn Thiel",
        "full_name_with_team": "[Lynch-Kertzmann] Quinn Thiel",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T12:45:03.804-08:00",
        "created_at": "2026-01-16T12:45:03.804-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "7c1a898d-48fc-4406-bfde-84cee8a7f7d7",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "9debd720-f412-40a3-a75e-43c90638c92c",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "c99de617-aac5-45c7-8b68-757a4387d28e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "07156480-9a6d-490c-8d81-b344454dceb1",
              "type": "user_notification_rules"
            },
            {
              "id": "85ac6538-4169-4dfb-89c1-5cd1e4daaac3",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "974",
      "type": "users",
      "attributes": {
        "name": "Valentine Erdman",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Valentine",
        "last_name": "Erdman",
        "full_name": "Valentine Erdman",
        "full_name_with_team": "[Lynch-Kertzmann] Valentine Erdman",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T12:45:03.730-08:00",
        "created_at": "2026-01-16T12:45:03.730-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "6a6872ac-49fa-4bb1-a395-b8a5ca2c6645",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "9debd720-f412-40a3-a75e-43c90638c92c",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "c99de617-aac5-45c7-8b68-757a4387d28e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "8bd20cb5-76c6-4954-b12d-5728c2717996",
              "type": "user_notification_rules"
            },
            {
              "id": "c7187bf1-dfc4-4626-83db-1917f5a6018f",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "973",
      "type": "users",
      "attributes": {
        "name": "Julian Fahey",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Julian",
        "last_name": "Fahey",
        "full_name": "Julian Fahey",
        "full_name_with_team": "[Lynch-Kertzmann] Julian Fahey",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T12:45:03.645-08:00",
        "created_at": "2026-01-16T12:45:03.645-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "7c3d24fc-7a5e-4958-a6fd-0ec2813a62e5",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "9debd720-f412-40a3-a75e-43c90638c92c",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "c99de617-aac5-45c7-8b68-757a4387d28e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "16a6bb5c-2ff7-4dc8-b983-cbc2ee47ba5e",
              "type": "user_notification_rules"
            },
            {
              "id": "cb9d1bc0-25d5-40c3-ab69-488ba14e5655",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "972",
      "type": "users",
      "attributes": {
        "name": "Micha Carter",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Micha",
        "last_name": "Carter",
        "full_name": "Micha Carter",
        "full_name_with_team": "[Lynch-Kertzmann] Micha Carter",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T12:45:03.557-08:00",
        "created_at": "2026-01-16T12:45:03.557-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "8ebf5a1c-dcc4-441f-a667-da6c0ab6e18c",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "9debd720-f412-40a3-a75e-43c90638c92c",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "c99de617-aac5-45c7-8b68-757a4387d28e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "b7083bab-d489-4d18-9238-0318b83ee3f5",
              "type": "user_notification_rules"
            },
            {
              "id": "1a38fd3b-ce25-4720-9aca-75c2f39527e0",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "971",
      "type": "users",
      "attributes": {
        "name": "My Kris",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "My",
        "last_name": "Kris",
        "full_name": "My Kris",
        "full_name_with_team": "[Lynch-Kertzmann] My Kris",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T12:45:03.483-08:00",
        "created_at": "2026-01-16T12:45:03.483-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "0991dfd7-18cd-4e57-b117-b55569345193",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "9debd720-f412-40a3-a75e-43c90638c92c",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "c99de617-aac5-45c7-8b68-757a4387d28e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "478296ae-e011-4981-8147-f71f26bbd08c",
              "type": "user_notification_rules"
            },
            {
              "id": "ff7f5b3e-87eb-448c-8d62-bb4b998b4b38",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "970",
      "type": "users",
      "attributes": {
        "name": "Paul Rolfson",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Paul",
        "last_name": "Rolfson",
        "full_name": "Paul Rolfson",
        "full_name_with_team": "[Lynch-Kertzmann] Paul Rolfson",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T12:45:03.408-08:00",
        "created_at": "2026-01-16T12:45:03.408-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "9a9e07a0-7e94-44cb-94ee-a05f99db6dca",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "9debd720-f412-40a3-a75e-43c90638c92c",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "c99de617-aac5-45c7-8b68-757a4387d28e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "74f6df9a-31c4-49dc-9eb8-6d33a4017ca4",
              "type": "user_notification_rules"
            },
            {
              "id": "2d7d6203-d5f3-498d-aaa8-b8fa07fffd74",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "969",
      "type": "users",
      "attributes": {
        "name": "Avery Kihn",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Avery",
        "last_name": "Kihn",
        "full_name": "Avery Kihn",
        "full_name_with_team": "[Lynch-Kertzmann] Avery Kihn",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-16T12:45:03.403-08:00",
        "created_at": "2026-01-16T12:45:03.105-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "bba93774-5072-4f41-9995-f09b6a50107a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "cc233747-722b-4885-948d-25c51bdb679b",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "c99de617-aac5-45c7-8b68-757a4387d28e",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "a97a5c36-d018-4709-a5fa-9dcf5aed0c19",
              "type": "user_notification_rules"
            },
            {
              "id": "eba1814c-74c3-41a4-80e5-97d84e98b282",
              "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