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": "631",
      "type": "users",
      "attributes": {
        "name": "Eboni Haag",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Eboni",
        "last_name": "Haag",
        "full_name": "Eboni Haag",
        "full_name_with_team": "[Mraz-Lynch] Eboni Haag",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-17T22:52:58.214-08:00",
        "created_at": "2025-12-17T22:52:58.214-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "954e0c33-332e-4234-bab0-4746a4f26863",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "3a33ad63-8c06-47d5-b544-8ccc4128c9ba",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "706abfa0-d9c2-4c8a-8dfb-e231cd314f8b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "86b5728b-434c-48df-9017-14e671850b70",
              "type": "user_notification_rules"
            },
            {
              "id": "a2ca3a1b-4fc4-4f37-a030-447ab92106bf",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "630",
      "type": "users",
      "attributes": {
        "name": "Jermaine Schoen",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Jermaine",
        "last_name": "Schoen",
        "full_name": "Jermaine Schoen",
        "full_name_with_team": "[Mraz-Lynch] Jermaine Schoen",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-17T22:52:58.106-08:00",
        "created_at": "2025-12-17T22:52:58.106-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "278826a9-f865-4cb6-b484-9d103a39b0f8",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "fa0e7b82-8006-4839-9498-57ab0ae4dc41",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "706abfa0-d9c2-4c8a-8dfb-e231cd314f8b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "2cd1cc5c-1c8c-42ad-abf5-2a7a20a72617",
              "type": "user_notification_rules"
            },
            {
              "id": "acd7500b-a74d-4be9-8cc1-2dc52da8e676",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "629",
      "type": "users",
      "attributes": {
        "name": "Blondell Aufderhar",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Blondell",
        "last_name": "Aufderhar",
        "full_name": "Blondell Aufderhar",
        "full_name_with_team": "[Mraz-Lynch] Blondell Aufderhar",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-17T22:52:57.961-08:00",
        "created_at": "2025-12-17T22:52:57.961-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "846be15f-e95a-43e4-b10d-3e8b82e9adb7",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "89a17bbd-71e1-402a-9709-288206760d53",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "706abfa0-d9c2-4c8a-8dfb-e231cd314f8b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "530b825d-a673-4894-aa85-0e6c4e5f4808",
              "type": "user_notification_rules"
            },
            {
              "id": "3fadf60a-3f8b-4c2c-a2d8-b0c4e4f22977",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "627",
      "type": "users",
      "attributes": {
        "name": "Lashanda Frami",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Lashanda",
        "last_name": "Frami",
        "full_name": "Lashanda Frami",
        "full_name_with_team": "[Mraz-Lynch] Lashanda Frami",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-17T22:52:57.426-08:00",
        "created_at": "2025-12-17T22:52:57.426-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "06a535dd-7c23-4d4f-86c9-a11a8969aa52",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "fa0e7b82-8006-4839-9498-57ab0ae4dc41",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "706abfa0-d9c2-4c8a-8dfb-e231cd314f8b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "78d66f9c-4772-42eb-9933-c139b52eb718",
              "type": "user_notification_rules"
            },
            {
              "id": "b1f7cb08-d0fb-4af3-ab11-4b52ab9e4b17",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "626",
      "type": "users",
      "attributes": {
        "name": "Darryl Crist",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Darryl",
        "last_name": "Crist",
        "full_name": "Darryl Crist",
        "full_name_with_team": "[Mraz-Lynch] Darryl Crist",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-17T22:52:57.360-08:00",
        "created_at": "2025-12-17T22:52:57.360-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "a847cbda-e920-457d-a4f4-7ea079c71839",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "fa0e7b82-8006-4839-9498-57ab0ae4dc41",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "706abfa0-d9c2-4c8a-8dfb-e231cd314f8b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "5dcf8b92-fb14-4e2d-8f66-ae962de4b8b8",
              "type": "user_notification_rules"
            },
            {
              "id": "eac14d14-3a98-4d61-8187-1ac9ccbb5c94",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "625",
      "type": "users",
      "attributes": {
        "name": "Glen Maggio",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Glen",
        "last_name": "Maggio",
        "full_name": "Glen Maggio",
        "full_name_with_team": "[Mraz-Lynch] Glen Maggio",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-17T22:52:57.285-08:00",
        "created_at": "2025-12-17T22:52:57.285-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "faf8a5cf-d5f8-4be7-9847-bcbbc44c843b",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "fa0e7b82-8006-4839-9498-57ab0ae4dc41",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "706abfa0-d9c2-4c8a-8dfb-e231cd314f8b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "52b16a65-cdbc-4321-b61d-8583a60399f9",
              "type": "user_notification_rules"
            },
            {
              "id": "454a7a21-7d9b-4020-ac79-390397c430ae",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "624",
      "type": "users",
      "attributes": {
        "name": "Deann Bergnaum",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Deann",
        "last_name": "Bergnaum",
        "full_name": "Deann Bergnaum",
        "full_name_with_team": "[Mraz-Lynch] Deann Bergnaum",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-17T22:52:57.219-08:00",
        "created_at": "2025-12-17T22:52:57.219-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "e24c383d-4c03-4621-aa8b-0250043273c6",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "fa0e7b82-8006-4839-9498-57ab0ae4dc41",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "706abfa0-d9c2-4c8a-8dfb-e231cd314f8b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "7ea4a36c-a96d-4161-b00e-6a8fea8161b2",
              "type": "user_notification_rules"
            },
            {
              "id": "a7a9e3e6-68ed-4bf8-8d4d-bbcf211ef7f2",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "623",
      "type": "users",
      "attributes": {
        "name": "Rodrick Thompson",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Rodrick",
        "last_name": "Thompson",
        "full_name": "Rodrick Thompson",
        "full_name_with_team": "[Mraz-Lynch] Rodrick Thompson",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-17T22:52:57.152-08:00",
        "created_at": "2025-12-17T22:52:57.152-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "ff298aa1-a8f7-4354-9df7-91cab138c27d",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "fa0e7b82-8006-4839-9498-57ab0ae4dc41",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "706abfa0-d9c2-4c8a-8dfb-e231cd314f8b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "2ffb2f7d-9bed-47ee-b95e-5f734652d32f",
              "type": "user_notification_rules"
            },
            {
              "id": "b8f48a03-1256-4cf2-945d-9cd02006236d",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "622",
      "type": "users",
      "attributes": {
        "name": "Leandra Herzog",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Leandra",
        "last_name": "Herzog",
        "full_name": "Leandra Herzog",
        "full_name_with_team": "[Mraz-Lynch] Leandra Herzog",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-17T22:52:57.083-08:00",
        "created_at": "2025-12-17T22:52:57.083-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "716f3921-468c-42b5-8fe6-7230eef82936",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "fa0e7b82-8006-4839-9498-57ab0ae4dc41",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "706abfa0-d9c2-4c8a-8dfb-e231cd314f8b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "c223ddab-df4d-4257-a00f-dfc857483d04",
              "type": "user_notification_rules"
            },
            {
              "id": "74611876-442f-4581-a43a-a89d1100d7e4",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "621",
      "type": "users",
      "attributes": {
        "name": "Courtney Blick",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Courtney",
        "last_name": "Blick",
        "full_name": "Courtney Blick",
        "full_name_with_team": "[Mraz-Lynch] Courtney Blick",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-17T22:52:57.014-08:00",
        "created_at": "2025-12-17T22:52:57.014-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "70225d14-b864-4716-8130-01124f2a1857",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "fa0e7b82-8006-4839-9498-57ab0ae4dc41",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "706abfa0-d9c2-4c8a-8dfb-e231cd314f8b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "cbabefe6-2634-4a59-8a88-c9c6c2842345",
              "type": "user_notification_rules"
            },
            {
              "id": "dd7cd2a5-b6e9-4096-948a-1af67a369ee2",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "620",
      "type": "users",
      "attributes": {
        "name": "Simonne Parisian",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Simonne",
        "last_name": "Parisian",
        "full_name": "Simonne Parisian",
        "full_name_with_team": "[Mraz-Lynch] Simonne Parisian",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-17T22:52:56.934-08:00",
        "created_at": "2025-12-17T22:52:56.934-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "c8a435d7-96c0-4971-84d4-842a5595f9e5",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "fa0e7b82-8006-4839-9498-57ab0ae4dc41",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "706abfa0-d9c2-4c8a-8dfb-e231cd314f8b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "10dea219-abc0-4f0b-805f-60a5bdd47de1",
              "type": "user_notification_rules"
            },
            {
              "id": "e9fc9ede-f64f-453f-a708-7f1a9abda5d4",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "619",
      "type": "users",
      "attributes": {
        "name": "Caleb Deckow",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Caleb",
        "last_name": "Deckow",
        "full_name": "Caleb Deckow",
        "full_name_with_team": "[Mraz-Lynch] Caleb Deckow",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-17T22:52:56.862-08:00",
        "created_at": "2025-12-17T22:52:56.862-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "10893ac9-ebf1-48b8-a885-f73fcaba2ba7",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "fa0e7b82-8006-4839-9498-57ab0ae4dc41",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "706abfa0-d9c2-4c8a-8dfb-e231cd314f8b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "3ea4edde-067a-4bf1-b5c7-88552ac56a12",
              "type": "user_notification_rules"
            },
            {
              "id": "209528de-1cb9-46f1-b387-c69a0ff0b0f6",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "618",
      "type": "users",
      "attributes": {
        "name": "Josette Olson",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Josette",
        "last_name": "Olson",
        "full_name": "Josette Olson",
        "full_name_with_team": "[Mraz-Lynch] Josette Olson",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-17T22:52:56.858-08:00",
        "created_at": "2025-12-17T22:52:56.584-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "20ab30cf-afb8-4231-8574-fbc8b5971ba8",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "89a17bbd-71e1-402a-9709-288206760d53",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "706abfa0-d9c2-4c8a-8dfb-e231cd314f8b",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "1adf13af-6ba7-437b-99e8-af1d123a6d90",
              "type": "user_notification_rules"
            },
            {
              "id": "88d9aa0a-5fc5-46d5-b49a-bb7f1b24d5f9",
              "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