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": "Tammara Rutherford",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Tammara",
        "last_name": "Rutherford",
        "full_name": "Tammara Rutherford",
        "full_name_with_team": "[McClure, Kirlin and Tromp] Tammara Rutherford",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-22T08:10:52.899-08:00",
        "created_at": "2026-01-22T08:10:52.899-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "a9e7b7b6-d7b9-4fce-b1d9-b8db4a27d5e8",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "6242c10a-5354-4768-bed8-eb4a239e99e7",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2795f100-d2ab-44ae-9bde-436bf3f59e8f",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "3f893f87-5e53-42d7-b96c-a3aab8f275c7",
              "type": "user_notification_rules"
            },
            {
              "id": "71b75380-71d5-4b20-9788-f88bd155c0fb",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "981",
      "type": "users",
      "attributes": {
        "name": "Shenita Ullrich",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Shenita",
        "last_name": "Ullrich",
        "full_name": "Shenita Ullrich",
        "full_name_with_team": "[McClure, Kirlin and Tromp] Shenita Ullrich",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-22T08:10:52.753-08:00",
        "created_at": "2026-01-22T08:10:52.753-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "aee21ca7-d864-4d20-9889-e0ce02023741",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b05e01f4-13d6-4ae1-8edc-ad4802e1dc33",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2795f100-d2ab-44ae-9bde-436bf3f59e8f",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "de0e2071-9983-4729-a981-ab9addc50a03",
              "type": "user_notification_rules"
            },
            {
              "id": "95b65d98-c7d9-4d6c-94a9-b04edcb3930d",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "980",
      "type": "users",
      "attributes": {
        "name": "Jan Schaden",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Jan",
        "last_name": "Schaden",
        "full_name": "Jan Schaden",
        "full_name_with_team": "[McClure, Kirlin and Tromp] Jan Schaden",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-22T08:10:52.541-08:00",
        "created_at": "2026-01-22T08:10:52.541-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "26017132-edb4-4325-be6d-5a839638f7a8",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c6f27a25-5c3e-4558-9e8a-70cafc74e607",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2795f100-d2ab-44ae-9bde-436bf3f59e8f",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "5332634d-67cf-4b27-b3af-c5a2fc1ac81e",
              "type": "user_notification_rules"
            },
            {
              "id": "77049679-cd89-4bcb-b9b6-65af011e1e84",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "978",
      "type": "users",
      "attributes": {
        "name": "Forest Schmeler",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Forest",
        "last_name": "Schmeler",
        "full_name": "Forest Schmeler",
        "full_name_with_team": "[McClure, Kirlin and Tromp] Forest Schmeler",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-22T08:10:51.650-08:00",
        "created_at": "2026-01-22T08:10:51.650-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "70dc74ba-5536-41d7-a525-bee1a8d03c50",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b05e01f4-13d6-4ae1-8edc-ad4802e1dc33",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2795f100-d2ab-44ae-9bde-436bf3f59e8f",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "dc47602f-5b66-4368-8b4d-3763f8eda685",
              "type": "user_notification_rules"
            },
            {
              "id": "168b1e42-410c-4356-adb1-3b06f2ffc39c",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "977",
      "type": "users",
      "attributes": {
        "name": "Sol Jacobi",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Sol",
        "last_name": "Jacobi",
        "full_name": "Sol Jacobi",
        "full_name_with_team": "[McClure, Kirlin and Tromp] Sol Jacobi",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-22T08:10:51.469-08:00",
        "created_at": "2026-01-22T08:10:51.469-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "1c0c4f7c-1b5b-477a-b203-14ae0dadcdc0",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b05e01f4-13d6-4ae1-8edc-ad4802e1dc33",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2795f100-d2ab-44ae-9bde-436bf3f59e8f",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "4bf30947-06e0-49ba-b911-40fc29de5b27",
              "type": "user_notification_rules"
            },
            {
              "id": "6c1b0c1b-1d97-447d-af12-ccb7da121e46",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "976",
      "type": "users",
      "attributes": {
        "name": "Ruth Johns",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Ruth",
        "last_name": "Johns",
        "full_name": "Ruth Johns",
        "full_name_with_team": "[McClure, Kirlin and Tromp] Ruth Johns",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-22T08:10:51.325-08:00",
        "created_at": "2026-01-22T08:10:51.325-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "2eda55fb-53da-44cd-85a0-cdb1ca3505a9",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b05e01f4-13d6-4ae1-8edc-ad4802e1dc33",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2795f100-d2ab-44ae-9bde-436bf3f59e8f",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "4d7c4a12-fc30-4b1c-b86e-5a852d2bf7cb",
              "type": "user_notification_rules"
            },
            {
              "id": "c0b1d69b-09f6-4a0d-b91b-864e92e4272c",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "975",
      "type": "users",
      "attributes": {
        "name": "Cleta Stark",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Cleta",
        "last_name": "Stark",
        "full_name": "Cleta Stark",
        "full_name_with_team": "[McClure, Kirlin and Tromp] Cleta Stark",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-22T08:10:51.150-08:00",
        "created_at": "2026-01-22T08:10:51.150-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "e4c0d8e1-5d68-4c9b-bd44-248f93b9ea59",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b05e01f4-13d6-4ae1-8edc-ad4802e1dc33",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2795f100-d2ab-44ae-9bde-436bf3f59e8f",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "69ef5de4-3d51-4422-b464-f787599b2541",
              "type": "user_notification_rules"
            },
            {
              "id": "33ebbb83-d212-4b63-99ca-b898fa5727e2",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "974",
      "type": "users",
      "attributes": {
        "name": "Loriann Swaniawski",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Loriann",
        "last_name": "Swaniawski",
        "full_name": "Loriann Swaniawski",
        "full_name_with_team": "[McClure, Kirlin and Tromp] Loriann Swaniawski",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-22T08:10:51.006-08:00",
        "created_at": "2026-01-22T08:10:51.006-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "8e7125c4-4a80-4144-82c3-527270500677",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b05e01f4-13d6-4ae1-8edc-ad4802e1dc33",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2795f100-d2ab-44ae-9bde-436bf3f59e8f",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "a3ab694c-6e76-4d23-916c-1af7c8530201",
              "type": "user_notification_rules"
            },
            {
              "id": "f85645cf-508a-4b11-a53d-35c418b31bb3",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "973",
      "type": "users",
      "attributes": {
        "name": "Brent Watsica",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Brent",
        "last_name": "Watsica",
        "full_name": "Brent Watsica",
        "full_name_with_team": "[McClure, Kirlin and Tromp] Brent Watsica",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-22T08:10:50.865-08:00",
        "created_at": "2026-01-22T08:10:50.865-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "895f4ecd-cf16-4814-8144-a9bfbf658874",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b05e01f4-13d6-4ae1-8edc-ad4802e1dc33",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2795f100-d2ab-44ae-9bde-436bf3f59e8f",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "e865d4a1-fbe2-41bb-8313-1300b82259d4",
              "type": "user_notification_rules"
            },
            {
              "id": "21e23434-00b8-4a25-a052-6d88ec40e9c5",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "972",
      "type": "users",
      "attributes": {
        "name": "Christen Gerhold",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Christen",
        "last_name": "Gerhold",
        "full_name": "Christen Gerhold",
        "full_name_with_team": "[McClure, Kirlin and Tromp] Christen Gerhold",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-22T08:10:50.645-08:00",
        "created_at": "2026-01-22T08:10:50.645-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "59e03f25-93eb-46cd-b2d3-d6a047aa1d76",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b05e01f4-13d6-4ae1-8edc-ad4802e1dc33",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2795f100-d2ab-44ae-9bde-436bf3f59e8f",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "7c2d851c-7eca-40f7-a4e3-3120c0df4929",
              "type": "user_notification_rules"
            },
            {
              "id": "76b0fdf6-1a25-4aa7-b881-0233e5a6624a",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "971",
      "type": "users",
      "attributes": {
        "name": "Alva Gerlach",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Alva",
        "last_name": "Gerlach",
        "full_name": "Alva Gerlach",
        "full_name_with_team": "[McClure, Kirlin and Tromp] Alva Gerlach",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-22T08:10:50.527-08:00",
        "created_at": "2026-01-22T08:10:50.527-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "19a5ed98-e59f-4dab-b8e6-86c887d02bb4",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b05e01f4-13d6-4ae1-8edc-ad4802e1dc33",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2795f100-d2ab-44ae-9bde-436bf3f59e8f",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "89e56d68-1ee9-4f1d-b4cc-b48cdfc7965c",
              "type": "user_notification_rules"
            },
            {
              "id": "90240928-3196-4a34-8ac8-9ebeb585736f",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "970",
      "type": "users",
      "attributes": {
        "name": "Walker Volkman",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Walker",
        "last_name": "Volkman",
        "full_name": "Walker Volkman",
        "full_name_with_team": "[McClure, Kirlin and Tromp] Walker Volkman",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-22T08:10:50.389-08:00",
        "created_at": "2026-01-22T08:10:50.389-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "c4faec2b-3b8d-41d2-8758-4af59c154fa3",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b05e01f4-13d6-4ae1-8edc-ad4802e1dc33",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2795f100-d2ab-44ae-9bde-436bf3f59e8f",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "24faa1cd-0bd2-4c6f-9615-7e2806b92d76",
              "type": "user_notification_rules"
            },
            {
              "id": "d811342b-4545-4b9e-bd84-98437bb32bf9",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "969",
      "type": "users",
      "attributes": {
        "name": "Andre Legros",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Andre",
        "last_name": "Legros",
        "full_name": "Andre Legros",
        "full_name_with_team": "[McClure, Kirlin and Tromp] Andre Legros",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-22T08:10:50.380-08:00",
        "created_at": "2026-01-22T08:10:49.927-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "aa027828-1ed1-402d-b5c3-ee237859d301",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c6f27a25-5c3e-4558-9e8a-70cafc74e607",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "2795f100-d2ab-44ae-9bde-436bf3f59e8f",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "6c553f63-3a69-4a0e-b0b3-d439a8caa06e",
              "type": "user_notification_rules"
            },
            {
              "id": "86e245a4-9fec-4e36-aba6-09faab54e0a1",
              "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[search]
string
​
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
​
links
object
required
​
meta
object
required