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": "565",
      "type": "users",
      "attributes": {
        "name": "Theo Welch",
        "email": "shad.botsford@oconnell.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Theo",
        "last_name": "Welch",
        "full_name": "Theo Welch",
        "full_name_with_team": "[Schultz LLC] Theo Welch",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-24T15:46:28.863-07:00",
        "created_at": "2025-10-24T15:46:28.863-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "f5fd1e4e-cc13-4f51-9714-322c3ca624dc",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "15289416-4df9-4a9e-a4cd-e307225e7416",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "945c89bd-120e-4a2e-92dd-14acedc429e1",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "71502fc0-4177-46bd-87f1-3b86801ea1eb",
              "type": "user_notification_rules"
            },
            {
              "id": "3ccada15-78c9-47c8-993d-3163fb11c7d2",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "564",
      "type": "users",
      "attributes": {
        "name": "Sammy Wolf",
        "email": "charlene_koepp@cartwright.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Sammy",
        "last_name": "Wolf",
        "full_name": "Sammy Wolf",
        "full_name_with_team": "[Schultz LLC] Sammy Wolf",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-24T15:46:28.738-07:00",
        "created_at": "2025-10-24T15:46:28.738-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "b5b10984-9719-477d-92c2-40c6cc3458e7",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c6e01ced-4547-4280-b711-ecc9a4f12713",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "945c89bd-120e-4a2e-92dd-14acedc429e1",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "a548badd-9297-465c-9910-fe844f345bd6",
              "type": "user_notification_rules"
            },
            {
              "id": "84a4ebdf-1cea-47e7-a3c6-408cd9857bf4",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "563",
      "type": "users",
      "attributes": {
        "name": "Norberto Haag",
        "email": "nancie.schamberger@klein.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Norberto",
        "last_name": "Haag",
        "full_name": "Norberto Haag",
        "full_name_with_team": "[Schultz LLC] Norberto Haag",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-24T15:46:28.575-07:00",
        "created_at": "2025-10-24T15:46:28.575-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "723afcaa-4235-4ca2-ae70-b73dbd332300",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "16954a29-baa4-4e15-bbba-489e852f036d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "945c89bd-120e-4a2e-92dd-14acedc429e1",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "33097986-42cb-4e60-94e0-7b0d38e9f557",
              "type": "user_notification_rules"
            },
            {
              "id": "b4ff79eb-9ea2-4669-9960-d662feafd3cf",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "561",
      "type": "users",
      "attributes": {
        "name": "Cassey O'Hara",
        "email": "gavin@osinski.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Cassey",
        "last_name": "O'Hara",
        "full_name": "Cassey O'Hara",
        "full_name_with_team": "[Schultz LLC] Cassey O'Hara",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-24T15:46:27.963-07:00",
        "created_at": "2025-10-24T15:46:27.963-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "23d2b333-e562-4b94-b26b-6b167dbea801",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c6e01ced-4547-4280-b711-ecc9a4f12713",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "945c89bd-120e-4a2e-92dd-14acedc429e1",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "2c41cdc6-d8f4-4ef5-9dd6-59f22d44a5e8",
              "type": "user_notification_rules"
            },
            {
              "id": "5c74739a-c885-455d-9cdc-1337641ce7cd",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "560",
      "type": "users",
      "attributes": {
        "name": "Arcelia Cole",
        "email": "domenica.hammes@flatley.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Arcelia",
        "last_name": "Cole",
        "full_name": "Arcelia Cole",
        "full_name_with_team": "[Schultz LLC] Arcelia Cole",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-24T15:46:27.857-07:00",
        "created_at": "2025-10-24T15:46:27.857-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "2dcbb3dc-8013-4ada-b243-9577c4bf1ee0",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c6e01ced-4547-4280-b711-ecc9a4f12713",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "945c89bd-120e-4a2e-92dd-14acedc429e1",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "d8ed1aa6-2e37-4af4-ac7a-cf5d1eb767b9",
              "type": "user_notification_rules"
            },
            {
              "id": "0fb2a810-b0fa-4bdd-b585-030bd0979d94",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "559",
      "type": "users",
      "attributes": {
        "name": "Kareem Beer",
        "email": "dane@brown.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Kareem",
        "last_name": "Beer",
        "full_name": "Kareem Beer",
        "full_name_with_team": "[Schultz LLC] Kareem Beer",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-24T15:46:27.744-07:00",
        "created_at": "2025-10-24T15:46:27.744-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "d0db2e07-baf5-4a9f-ba45-ba2983d39378",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c6e01ced-4547-4280-b711-ecc9a4f12713",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "945c89bd-120e-4a2e-92dd-14acedc429e1",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "36fa8657-3e1c-422c-bbcf-b2699d64e6f2",
              "type": "user_notification_rules"
            },
            {
              "id": "ce423ea3-8602-4d30-b470-68a13f6d0f55",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "558",
      "type": "users",
      "attributes": {
        "name": "Nelida Harber",
        "email": "candace@marvin-abshire.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Nelida",
        "last_name": "Harber",
        "full_name": "Nelida Harber",
        "full_name_with_team": "[Schultz LLC] Nelida Harber",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-24T15:46:27.630-07:00",
        "created_at": "2025-10-24T15:46:27.630-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "7fd76584-34ca-46f6-b166-781bf2d003f2",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c6e01ced-4547-4280-b711-ecc9a4f12713",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "945c89bd-120e-4a2e-92dd-14acedc429e1",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "fd5037b5-d72b-4f90-847a-84836a6b1451",
              "type": "user_notification_rules"
            },
            {
              "id": "997ede61-737e-4eeb-bbc3-2f84e7a87b49",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "557",
      "type": "users",
      "attributes": {
        "name": "Lauretta Fahey",
        "email": "adolfo@marks.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Lauretta",
        "last_name": "Fahey",
        "full_name": "Lauretta Fahey",
        "full_name_with_team": "[Schultz LLC] Lauretta Fahey",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-24T15:46:27.520-07:00",
        "created_at": "2025-10-24T15:46:27.520-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "f204a8d1-b443-4173-882d-284be37edd2e",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c6e01ced-4547-4280-b711-ecc9a4f12713",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "945c89bd-120e-4a2e-92dd-14acedc429e1",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "95ee6428-9089-47a9-85a8-60bbf370bbe2",
              "type": "user_notification_rules"
            },
            {
              "id": "9cd6c679-321f-4e24-81af-a9150741ae4c",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "556",
      "type": "users",
      "attributes": {
        "name": "Everette Lockman",
        "email": "lazaro@hagenes.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Everette",
        "last_name": "Lockman",
        "full_name": "Everette Lockman",
        "full_name_with_team": "[Schultz LLC] Everette Lockman",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-24T15:46:27.400-07:00",
        "created_at": "2025-10-24T15:46:27.400-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "a8d9d4c6-8f84-445d-9965-4766963674b7",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c6e01ced-4547-4280-b711-ecc9a4f12713",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "945c89bd-120e-4a2e-92dd-14acedc429e1",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "8cc043da-6335-40dc-9d9a-bcacf50e3753",
              "type": "user_notification_rules"
            },
            {
              "id": "327881ca-c377-409e-b133-2c6323561b3e",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "555",
      "type": "users",
      "attributes": {
        "name": "Terry Stark",
        "email": "veronica@jacobs.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Terry",
        "last_name": "Stark",
        "full_name": "Terry Stark",
        "full_name_with_team": "[Schultz LLC] Terry Stark",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-24T15:46:27.284-07:00",
        "created_at": "2025-10-24T15:46:27.284-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "3ba51813-2c3a-4beb-8200-70fedcebbb1c",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c6e01ced-4547-4280-b711-ecc9a4f12713",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "945c89bd-120e-4a2e-92dd-14acedc429e1",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "45fa8f85-c092-4fa7-9f5b-b463398ae33c",
              "type": "user_notification_rules"
            },
            {
              "id": "a738744a-95ee-444a-9ee1-6b4d40d1dd72",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "554",
      "type": "users",
      "attributes": {
        "name": "Landon McClure",
        "email": "tommie.oconner@batz-johnson.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Landon",
        "last_name": "McClure",
        "full_name": "Landon McClure",
        "full_name_with_team": "[Schultz LLC] Landon McClure",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-24T15:46:27.168-07:00",
        "created_at": "2025-10-24T15:46:27.168-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "8b8e4588-7fab-4e50-bfac-9e1bc5e98622",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c6e01ced-4547-4280-b711-ecc9a4f12713",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "945c89bd-120e-4a2e-92dd-14acedc429e1",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "7a6c34ca-f28a-4072-8203-a83679ef2c3d",
              "type": "user_notification_rules"
            },
            {
              "id": "d5d90887-e9bd-48ef-bff9-cea2347cffab",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "553",
      "type": "users",
      "attributes": {
        "name": "Gregorio Bashirian",
        "email": "fidel@wisoky.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Gregorio",
        "last_name": "Bashirian",
        "full_name": "Gregorio Bashirian",
        "full_name_with_team": "[Schultz LLC] Gregorio Bashirian",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-24T15:46:27.048-07:00",
        "created_at": "2025-10-24T15:46:27.048-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "5720c6f4-4d86-4445-af3b-c46d6b9180d3",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c6e01ced-4547-4280-b711-ecc9a4f12713",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "945c89bd-120e-4a2e-92dd-14acedc429e1",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "6b5ade0d-e86b-46de-adde-52482d52a752",
              "type": "user_notification_rules"
            },
            {
              "id": "c5d93c89-b04b-4172-8ced-932d15d47dd6",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "552",
      "type": "users",
      "attributes": {
        "name": "Brittny Russel",
        "email": "jeffrey@murazik.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Brittny",
        "last_name": "Russel",
        "full_name": "Brittny Russel",
        "full_name_with_team": "[Schultz LLC] Brittny Russel",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-24T15:46:27.041-07:00",
        "created_at": "2025-10-24T15:46:26.506-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "83f0da49-e3bc-4476-9eb2-46baf63561b7",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "16954a29-baa4-4e15-bbba-489e852f036d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "945c89bd-120e-4a2e-92dd-14acedc429e1",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "e36f9880-edde-4355-aae9-fa658d516e71",
              "type": "user_notification_rules"
            },
            {
              "id": "21e31c0f-8be5-4d88-bede-fe5f01885194",
              "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
I