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": "629",
      "type": "users",
      "attributes": {
        "name": "Enriqueta Cormier",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Enriqueta",
        "last_name": "Cormier",
        "full_name": "Enriqueta Cormier",
        "full_name_with_team": "[Veum Inc] Enriqueta Cormier",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-08T09:19:16.859-08:00",
        "created_at": "2025-12-08T09:19:16.859-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "42431ab6-f35f-4438-a84c-b3be9f1ab2d6",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "aa080220-d72d-4945-8bca-f20ba6f14f2c",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "04e7021e-7536-4ed6-b2e2-ff1523faaa80",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "95b6472e-82d7-4669-b6a9-f87d0f838043",
              "type": "user_notification_rules"
            },
            {
              "id": "8705a3b7-6b01-4ace-9aba-e108f78beb86",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "628",
      "type": "users",
      "attributes": {
        "name": "Romana Koss",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Romana",
        "last_name": "Koss",
        "full_name": "Romana Koss",
        "full_name_with_team": "[Veum Inc] Romana Koss",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-08T09:19:16.728-08:00",
        "created_at": "2025-12-08T09:19:16.728-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "6a4dc8e8-92f3-4ea2-9404-5a827da814d7",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d12e5b18-9350-444b-8e5c-0addd4aac121",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "04e7021e-7536-4ed6-b2e2-ff1523faaa80",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "ef77e6e8-93d4-4941-b4b8-99267baecfa1",
              "type": "user_notification_rules"
            },
            {
              "id": "f6bdc8c7-b871-4550-bbb8-782a64373f84",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "627",
      "type": "users",
      "attributes": {
        "name": "Wilson Muller",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Wilson",
        "last_name": "Muller",
        "full_name": "Wilson Muller",
        "full_name_with_team": "[Veum Inc] Wilson Muller",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-08T09:19:16.572-08:00",
        "created_at": "2025-12-08T09:19:16.572-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "3a21441c-1254-4d25-9410-4a1869c146f0",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c3e83c15-ae63-4788-b27f-0b19aa5fc8c2",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "04e7021e-7536-4ed6-b2e2-ff1523faaa80",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "f1e15fe0-d836-45b3-9328-59b00b925496",
              "type": "user_notification_rules"
            },
            {
              "id": "fc383589-7e95-472d-80db-455479ca855e",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "625",
      "type": "users",
      "attributes": {
        "name": "Lashonda Gottlieb",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Lashonda",
        "last_name": "Gottlieb",
        "full_name": "Lashonda Gottlieb",
        "full_name_with_team": "[Veum Inc] Lashonda Gottlieb",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-08T09:19:15.938-08:00",
        "created_at": "2025-12-08T09:19:15.938-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "28505b80-3a18-4d3f-a6c1-15a13d96e326",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d12e5b18-9350-444b-8e5c-0addd4aac121",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "04e7021e-7536-4ed6-b2e2-ff1523faaa80",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "abeb3f7e-fa51-451b-9593-fbd746466ff8",
              "type": "user_notification_rules"
            },
            {
              "id": "9745e717-1db8-4070-bffb-373c7abf77d4",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "624",
      "type": "users",
      "attributes": {
        "name": "Helene Skiles",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Helene",
        "last_name": "Skiles",
        "full_name": "Helene Skiles",
        "full_name_with_team": "[Veum Inc] Helene Skiles",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-08T09:19:15.830-08:00",
        "created_at": "2025-12-08T09:19:15.830-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "4b190b5f-d714-48da-a1c7-1bc34836fe5f",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d12e5b18-9350-444b-8e5c-0addd4aac121",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "04e7021e-7536-4ed6-b2e2-ff1523faaa80",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "3e643fc9-88f4-41bc-bcc4-1747f8d537bf",
              "type": "user_notification_rules"
            },
            {
              "id": "56373a37-7635-44aa-a838-9f675d023092",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "623",
      "type": "users",
      "attributes": {
        "name": "Tim Paucek",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Tim",
        "last_name": "Paucek",
        "full_name": "Tim Paucek",
        "full_name_with_team": "[Veum Inc] Tim Paucek",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-08T09:19:15.724-08:00",
        "created_at": "2025-12-08T09:19:15.724-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "9a9f62df-e63b-454b-b39c-3af8de89a49d",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d12e5b18-9350-444b-8e5c-0addd4aac121",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "04e7021e-7536-4ed6-b2e2-ff1523faaa80",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "ee7256cd-7654-4454-95e0-8284e1b82e92",
              "type": "user_notification_rules"
            },
            {
              "id": "d7f65e49-8967-45f6-ad6b-33d95f793fc8",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "622",
      "type": "users",
      "attributes": {
        "name": "Julian Corkery",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Julian",
        "last_name": "Corkery",
        "full_name": "Julian Corkery",
        "full_name_with_team": "[Veum Inc] Julian Corkery",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-08T09:19:15.624-08:00",
        "created_at": "2025-12-08T09:19:15.624-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "46f832ec-3c29-40ca-bd74-d8f009da5c75",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d12e5b18-9350-444b-8e5c-0addd4aac121",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "04e7021e-7536-4ed6-b2e2-ff1523faaa80",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "435db68d-93bb-4a67-a53f-bac82eb66c74",
              "type": "user_notification_rules"
            },
            {
              "id": "982b804a-c5d9-4a28-8de3-edce68769590",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "621",
      "type": "users",
      "attributes": {
        "name": "Jeanette Rippin",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Jeanette",
        "last_name": "Rippin",
        "full_name": "Jeanette Rippin",
        "full_name_with_team": "[Veum Inc] Jeanette Rippin",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-08T09:19:15.479-08:00",
        "created_at": "2025-12-08T09:19:15.479-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "0f4d4e27-b321-4872-9350-dace20175b19",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d12e5b18-9350-444b-8e5c-0addd4aac121",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "04e7021e-7536-4ed6-b2e2-ff1523faaa80",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "da990d2b-9f8c-4f62-98cd-e97079dde807",
              "type": "user_notification_rules"
            },
            {
              "id": "8d0819a1-b184-4498-a951-4414222b1a66",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "620",
      "type": "users",
      "attributes": {
        "name": "Rebbeca Halvorson",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Rebbeca",
        "last_name": "Halvorson",
        "full_name": "Rebbeca Halvorson",
        "full_name_with_team": "[Veum Inc] Rebbeca Halvorson",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-08T09:19:15.373-08:00",
        "created_at": "2025-12-08T09:19:15.373-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "de9ec3ec-953c-4f5a-9f85-467383908143",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d12e5b18-9350-444b-8e5c-0addd4aac121",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "04e7021e-7536-4ed6-b2e2-ff1523faaa80",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "bc629685-3861-4088-8f89-8ecd38a5f35b",
              "type": "user_notification_rules"
            },
            {
              "id": "26412b15-e67d-43f6-8e69-f52930757031",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "619",
      "type": "users",
      "attributes": {
        "name": "Jorge Windler",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Jorge",
        "last_name": "Windler",
        "full_name": "Jorge Windler",
        "full_name_with_team": "[Veum Inc] Jorge Windler",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-08T09:19:15.260-08:00",
        "created_at": "2025-12-08T09:19:15.260-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "efc802c5-8366-4a49-93a3-3f83a784e6c0",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d12e5b18-9350-444b-8e5c-0addd4aac121",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "04e7021e-7536-4ed6-b2e2-ff1523faaa80",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "18da24cd-c472-4243-b6bd-5c2e350548d3",
              "type": "user_notification_rules"
            },
            {
              "id": "2793ac0a-75b9-4bae-9f39-d789fa313b5b",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "618",
      "type": "users",
      "attributes": {
        "name": "Cori Hintz",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Cori",
        "last_name": "Hintz",
        "full_name": "Cori Hintz",
        "full_name_with_team": "[Veum Inc] Cori Hintz",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-08T09:19:15.158-08:00",
        "created_at": "2025-12-08T09:19:15.158-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "1acfe382-b7e0-4143-b661-18a5df367dcf",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d12e5b18-9350-444b-8e5c-0addd4aac121",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "04e7021e-7536-4ed6-b2e2-ff1523faaa80",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "e389876b-4a4a-47cf-a9fb-10911d19a32a",
              "type": "user_notification_rules"
            },
            {
              "id": "6e72f990-96a5-4d7b-8c15-5ab31261ced9",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "617",
      "type": "users",
      "attributes": {
        "name": "Wade Mertz",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Wade",
        "last_name": "Mertz",
        "full_name": "Wade Mertz",
        "full_name_with_team": "[Veum Inc] Wade Mertz",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-08T09:19:15.050-08:00",
        "created_at": "2025-12-08T09:19:15.050-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "42168c40-7596-4dc5-a44c-681207d33f7d",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d12e5b18-9350-444b-8e5c-0addd4aac121",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "04e7021e-7536-4ed6-b2e2-ff1523faaa80",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "7a86aa21-972e-4372-862b-73137e77eaad",
              "type": "user_notification_rules"
            },
            {
              "id": "a101cb66-60e1-49ed-b8fe-e2ac91d4c145",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "616",
      "type": "users",
      "attributes": {
        "name": "Aaron Satterfield",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Aaron",
        "last_name": "Satterfield",
        "full_name": "Aaron Satterfield",
        "full_name_with_team": "[Veum Inc] Aaron Satterfield",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-12-08T09:19:15.044-08:00",
        "created_at": "2025-12-08T09:19:14.654-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "086e218b-7f78-4827-ab33-92256ae400de",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c3e83c15-ae63-4788-b27f-0b19aa5fc8c2",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "04e7021e-7536-4ed6-b2e2-ff1523faaa80",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "accf1fca-b4bb-4ef8-8f99-d15d94639adf",
              "type": "user_notification_rules"
            },
            {
              "id": "9e6e596d-fbcf-4a86-9add-e300d0489992",
              "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