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": "983",
      "type": "users",
      "attributes": {
        "name": "Rhoda Brown",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Rhoda",
        "last_name": "Brown",
        "full_name": "Rhoda Brown",
        "full_name_with_team": "[Cassin, Strosin and Lueilwitz] Rhoda Brown",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-27T09:57:11.568-08:00",
        "created_at": "2026-01-27T09:57:11.568-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "7c11d55f-ec91-4610-b30c-cac6eb56fb52",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "1582f19a-bbd8-4c28-b3a8-7e6959aa825d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "a440efd4-87fa-4f39-95cd-a574aa763129",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "34f1b6ff-7fa3-49ae-a271-4201fb225b12",
              "type": "user_notification_rules"
            },
            {
              "id": "bb594cf4-4a5e-4690-b910-9661fd70ab54",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "982",
      "type": "users",
      "attributes": {
        "name": "Moshe Kozey",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Moshe",
        "last_name": "Kozey",
        "full_name": "Moshe Kozey",
        "full_name_with_team": "[Cassin, Strosin and Lueilwitz] Moshe Kozey",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-27T09:57:11.468-08:00",
        "created_at": "2026-01-27T09:57:11.468-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "bd809308-2924-4aa7-abcc-0ca629ec4d84",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0f5808bb-abb5-4a80-9165-a3aaf98a1b2d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "a440efd4-87fa-4f39-95cd-a574aa763129",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "21314781-6bfc-4077-bd4f-8301ee5adae1",
              "type": "user_notification_rules"
            },
            {
              "id": "a6c75290-0d63-4e10-bf53-55fc5b3e6855",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "981",
      "type": "users",
      "attributes": {
        "name": "Patrick Dach",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Patrick",
        "last_name": "Dach",
        "full_name": "Patrick Dach",
        "full_name_with_team": "[Cassin, Strosin and Lueilwitz] Patrick Dach",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-27T09:57:11.328-08:00",
        "created_at": "2026-01-27T09:57:11.328-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "8dc78de8-696d-486d-8849-6d4077b12212",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "df04ba4b-1fcc-4109-b8f8-7b3e7587e25a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "a440efd4-87fa-4f39-95cd-a574aa763129",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "71add415-3409-4da5-8d90-669f9de7a701",
              "type": "user_notification_rules"
            },
            {
              "id": "777307a1-0217-4b72-860a-df405e03b84d",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "979",
      "type": "users",
      "attributes": {
        "name": "Omar Hilpert",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Omar",
        "last_name": "Hilpert",
        "full_name": "Omar Hilpert",
        "full_name_with_team": "[Cassin, Strosin and Lueilwitz] Omar Hilpert",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-27T09:57:05.872-08:00",
        "created_at": "2026-01-27T09:57:05.872-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "3240be53-f888-4295-81a6-ee4d02e44277",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0f5808bb-abb5-4a80-9165-a3aaf98a1b2d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "a440efd4-87fa-4f39-95cd-a574aa763129",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "889945b2-86ae-4ac1-a3b0-c605a9b17172",
              "type": "user_notification_rules"
            },
            {
              "id": "b921ac24-44a5-40c4-b9cc-022b7a14cf8b",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "978",
      "type": "users",
      "attributes": {
        "name": "Alix Tillman",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Alix",
        "last_name": "Tillman",
        "full_name": "Alix Tillman",
        "full_name_with_team": "[Cassin, Strosin and Lueilwitz] Alix Tillman",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-27T09:57:05.798-08:00",
        "created_at": "2026-01-27T09:57:05.798-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "68526037-e564-4362-8ffe-2e94fa88de7b",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0f5808bb-abb5-4a80-9165-a3aaf98a1b2d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "a440efd4-87fa-4f39-95cd-a574aa763129",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "75d4df3f-b686-4388-b479-582ef1fe3e42",
              "type": "user_notification_rules"
            },
            {
              "id": "c00d3433-6cca-4834-b7ef-80f31d1fed7d",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "977",
      "type": "users",
      "attributes": {
        "name": "Lia Konopelski",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Lia",
        "last_name": "Konopelski",
        "full_name": "Lia Konopelski",
        "full_name_with_team": "[Cassin, Strosin and Lueilwitz] Lia Konopelski",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-27T09:57:05.713-08:00",
        "created_at": "2026-01-27T09:57:05.713-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "f186a0d6-90c6-4375-ad30-a8b906be4e84",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0f5808bb-abb5-4a80-9165-a3aaf98a1b2d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "a440efd4-87fa-4f39-95cd-a574aa763129",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "ab14e03d-257a-45be-8f0a-fb7c0099a764",
              "type": "user_notification_rules"
            },
            {
              "id": "c2041431-9fa8-446f-af8f-21e7da30e44f",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "976",
      "type": "users",
      "attributes": {
        "name": "Romeo Reilly",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Romeo",
        "last_name": "Reilly",
        "full_name": "Romeo Reilly",
        "full_name_with_team": "[Cassin, Strosin and Lueilwitz] Romeo Reilly",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-27T09:57:05.616-08:00",
        "created_at": "2026-01-27T09:57:05.616-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "45612cec-b678-451a-8e44-629e96645c7a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0f5808bb-abb5-4a80-9165-a3aaf98a1b2d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "a440efd4-87fa-4f39-95cd-a574aa763129",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "681850c4-3e2f-45c0-8b5c-d96acb45a2f5",
              "type": "user_notification_rules"
            },
            {
              "id": "aaff70db-43f2-418b-b986-573b3cc165d8",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "975",
      "type": "users",
      "attributes": {
        "name": "Landon Ziemann",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Landon",
        "last_name": "Ziemann",
        "full_name": "Landon Ziemann",
        "full_name_with_team": "[Cassin, Strosin and Lueilwitz] Landon Ziemann",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-27T09:57:05.525-08:00",
        "created_at": "2026-01-27T09:57:05.525-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "b621dea3-032c-4099-9dc8-c36407d78381",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0f5808bb-abb5-4a80-9165-a3aaf98a1b2d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "a440efd4-87fa-4f39-95cd-a574aa763129",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "54a3580b-191b-4d5b-a783-b71767d92f87",
              "type": "user_notification_rules"
            },
            {
              "id": "138ca6c4-f1f6-45ef-87a9-8fd7a7898daf",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "974",
      "type": "users",
      "attributes": {
        "name": "Shenna Towne",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Shenna",
        "last_name": "Towne",
        "full_name": "Shenna Towne",
        "full_name_with_team": "[Cassin, Strosin and Lueilwitz] Shenna Towne",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-27T09:57:05.429-08:00",
        "created_at": "2026-01-27T09:57:05.429-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "de2d6996-1d01-4409-9af2-7544f4671ccc",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0f5808bb-abb5-4a80-9165-a3aaf98a1b2d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "a440efd4-87fa-4f39-95cd-a574aa763129",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "7f8db716-256e-4d6f-878c-845c0d6654eb",
              "type": "user_notification_rules"
            },
            {
              "id": "d35567f1-7658-420b-824f-65f5d8917aea",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "973",
      "type": "users",
      "attributes": {
        "name": "Marcos Flatley",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Marcos",
        "last_name": "Flatley",
        "full_name": "Marcos Flatley",
        "full_name_with_team": "[Cassin, Strosin and Lueilwitz] Marcos Flatley",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-27T09:57:05.339-08:00",
        "created_at": "2026-01-27T09:57:05.339-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "7009dee7-9b64-40ac-950b-6142248b4e15",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0f5808bb-abb5-4a80-9165-a3aaf98a1b2d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "a440efd4-87fa-4f39-95cd-a574aa763129",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "a72cb384-21dd-417f-8420-bb60a3535696",
              "type": "user_notification_rules"
            },
            {
              "id": "1df21954-5c78-4c01-b661-0ad115b42c26",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "972",
      "type": "users",
      "attributes": {
        "name": "Zachery Mills",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Zachery",
        "last_name": "Mills",
        "full_name": "Zachery Mills",
        "full_name_with_team": "[Cassin, Strosin and Lueilwitz] Zachery Mills",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-27T09:57:05.235-08:00",
        "created_at": "2026-01-27T09:57:05.235-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "b95e16e7-ad56-4a21-94a2-22b3ca593f3b",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0f5808bb-abb5-4a80-9165-a3aaf98a1b2d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "a440efd4-87fa-4f39-95cd-a574aa763129",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "9dfd8712-eaf5-42f2-826b-a6312ef95ff1",
              "type": "user_notification_rules"
            },
            {
              "id": "bf373a19-ce63-4345-9e0a-9fde70acffa3",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "971",
      "type": "users",
      "attributes": {
        "name": "Jacquelyn Heidenreich",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Jacquelyn",
        "last_name": "Heidenreich",
        "full_name": "Jacquelyn Heidenreich",
        "full_name_with_team": "[Cassin, Strosin and Lueilwitz] Jacquelyn Heidenreich",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-27T09:57:05.092-08:00",
        "created_at": "2026-01-27T09:57:05.092-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "6f8e0b0b-7e30-4cff-8d76-da0f1c84920c",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0f5808bb-abb5-4a80-9165-a3aaf98a1b2d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "a440efd4-87fa-4f39-95cd-a574aa763129",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "e3a10a1b-e065-42d7-81f7-26a0ee3f12e0",
              "type": "user_notification_rules"
            },
            {
              "id": "9bba9fd6-6159-4710-bf34-7a95a6d7ea39",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "970",
      "type": "users",
      "attributes": {
        "name": "Kerry Larson",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Kerry",
        "last_name": "Larson",
        "full_name": "Kerry Larson",
        "full_name_with_team": "[Cassin, Strosin and Lueilwitz] Kerry Larson",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-27T09:57:05.088-08:00",
        "created_at": "2026-01-27T09:57:04.809-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "db4749a0-f2d0-4100-9ed4-ab04dc638564",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "df04ba4b-1fcc-4109-b8f8-7b3e7587e25a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "a440efd4-87fa-4f39-95cd-a574aa763129",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "33a5a081-da23-427a-a272-f91e9fd64a55",
              "type": "user_notification_rules"
            },
            {
              "id": "f4b0a4e5-7ee0-42bd-b9fb-f413d20de039",
              "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