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": "1170",
      "type": "users",
      "attributes": {
        "name": "Camila Langworth",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Camila",
        "last_name": "Langworth",
        "full_name": "Camila Langworth",
        "full_name_with_team": "[Franecki, Harvey and Heller] Camila Langworth",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-13T18:10:49.931-08:00",
        "created_at": "2026-02-13T18:10:49.931-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "28f5f27a-8bd3-4cca-bf04-603b18ffbfee",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c7c88677-9b53-4677-a4e9-077129b3bb98",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "de8fc2c9-3d96-4721-8295-b46283d77b66",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "456aa8ee-917e-4b62-9222-285dde689b77",
              "type": "user_notification_rules"
            },
            {
              "id": "40684e51-e58b-4e08-aae2-dd75ed927072",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1169",
      "type": "users",
      "attributes": {
        "name": "Barney Borer",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Barney",
        "last_name": "Borer",
        "full_name": "Barney Borer",
        "full_name_with_team": "[Franecki, Harvey and Heller] Barney Borer",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-13T18:10:49.859-08:00",
        "created_at": "2026-02-13T18:10:49.859-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "70f5b138-5eef-449b-b10f-9e7491e34f2b",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "cadafd0f-a014-49a2-862d-ca71a3b5e30a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "de8fc2c9-3d96-4721-8295-b46283d77b66",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "09e67cd3-e151-440c-b718-9312572ea1ca",
              "type": "user_notification_rules"
            },
            {
              "id": "4920bf8f-cd8b-4a73-bd3a-32c9716745ac",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1168",
      "type": "users",
      "attributes": {
        "name": "Melvin Treutel",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Melvin",
        "last_name": "Treutel",
        "full_name": "Melvin Treutel",
        "full_name_with_team": "[Franecki, Harvey and Heller] Melvin Treutel",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-13T18:10:49.771-08:00",
        "created_at": "2026-02-13T18:10:49.771-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "8752de7b-cba5-4afa-87b9-d971bc8d8c2a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c4d9d437-adb3-4100-8301-40bde7b5374b",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "de8fc2c9-3d96-4721-8295-b46283d77b66",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "af87640b-fc69-4ecc-9462-48ad06f7354c",
              "type": "user_notification_rules"
            },
            {
              "id": "c4700bed-9175-4066-84a6-cc8476cee12f",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1166",
      "type": "users",
      "attributes": {
        "name": "Giselle Blanda",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Giselle",
        "last_name": "Blanda",
        "full_name": "Giselle Blanda",
        "full_name_with_team": "[Franecki, Harvey and Heller] Giselle Blanda",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-13T18:10:49.358-08:00",
        "created_at": "2026-02-13T18:10:49.358-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "4a6b27a9-8a3b-4ff7-bd20-01157a9bd496",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "cadafd0f-a014-49a2-862d-ca71a3b5e30a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "de8fc2c9-3d96-4721-8295-b46283d77b66",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "a0c6ddb6-c9c9-41c0-bdf5-2f676702e890",
              "type": "user_notification_rules"
            },
            {
              "id": "372ac07a-91d5-4c7d-ac71-dc1679f0d16b",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1165",
      "type": "users",
      "attributes": {
        "name": "Lisette Cormier",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Lisette",
        "last_name": "Cormier",
        "full_name": "Lisette Cormier",
        "full_name_with_team": "[Franecki, Harvey and Heller] Lisette Cormier",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-13T18:10:49.302-08:00",
        "created_at": "2026-02-13T18:10:49.302-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "506eab81-2723-4a58-8a08-2ef2503a006e",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "cadafd0f-a014-49a2-862d-ca71a3b5e30a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "de8fc2c9-3d96-4721-8295-b46283d77b66",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "3420c151-c9de-4801-91b2-d636f7db3e01",
              "type": "user_notification_rules"
            },
            {
              "id": "115c80d9-dce3-4ea2-84b2-4ef83c6aec4d",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1164",
      "type": "users",
      "attributes": {
        "name": "Gary Waelchi",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Gary",
        "last_name": "Waelchi",
        "full_name": "Gary Waelchi",
        "full_name_with_team": "[Franecki, Harvey and Heller] Gary Waelchi",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-13T18:10:49.246-08:00",
        "created_at": "2026-02-13T18:10:49.246-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "131cf7aa-3146-4b63-a07d-ae6606006325",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "cadafd0f-a014-49a2-862d-ca71a3b5e30a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "de8fc2c9-3d96-4721-8295-b46283d77b66",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "35119cb6-4961-4f57-980d-d44b2c90e6cb",
              "type": "user_notification_rules"
            },
            {
              "id": "dfb8950a-4e76-4a7d-b7bf-0476093bf6ec",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1163",
      "type": "users",
      "attributes": {
        "name": "Lai Lebsack",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Lai",
        "last_name": "Lebsack",
        "full_name": "Lai Lebsack",
        "full_name_with_team": "[Franecki, Harvey and Heller] Lai Lebsack",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-13T18:10:49.185-08:00",
        "created_at": "2026-02-13T18:10:49.185-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "d5577725-b0cb-4f7e-be76-b12a213d3916",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "cadafd0f-a014-49a2-862d-ca71a3b5e30a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "de8fc2c9-3d96-4721-8295-b46283d77b66",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "05b0dc2d-bc94-455f-addc-05782925da8e",
              "type": "user_notification_rules"
            },
            {
              "id": "1c9e79a4-6a71-467f-9f84-5402ef000a7c",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1162",
      "type": "users",
      "attributes": {
        "name": "Fern Bradtke",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Fern",
        "last_name": "Bradtke",
        "full_name": "Fern Bradtke",
        "full_name_with_team": "[Franecki, Harvey and Heller] Fern Bradtke",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-13T18:10:49.129-08:00",
        "created_at": "2026-02-13T18:10:49.129-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "511565b2-e191-4b3b-9027-2234586da495",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "cadafd0f-a014-49a2-862d-ca71a3b5e30a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "de8fc2c9-3d96-4721-8295-b46283d77b66",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "21e330aa-3904-498e-b6ef-fc0966988143",
              "type": "user_notification_rules"
            },
            {
              "id": "a70cdb9a-bbc4-4636-8432-fc2ab31cc0a0",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1161",
      "type": "users",
      "attributes": {
        "name": "Teodoro Jenkins",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Teodoro",
        "last_name": "Jenkins",
        "full_name": "Teodoro Jenkins",
        "full_name_with_team": "[Franecki, Harvey and Heller] Teodoro Jenkins",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-13T18:10:49.072-08:00",
        "created_at": "2026-02-13T18:10:49.072-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "603f57f1-6c7c-4237-8b54-c79c7fc1667d",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "cadafd0f-a014-49a2-862d-ca71a3b5e30a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "de8fc2c9-3d96-4721-8295-b46283d77b66",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "53b2ff32-7a8a-46c6-9959-dc0d730f2345",
              "type": "user_notification_rules"
            },
            {
              "id": "95864111-2899-4aa9-bd74-20762ce098bf",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1160",
      "type": "users",
      "attributes": {
        "name": "Doretta Johnston",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Doretta",
        "last_name": "Johnston",
        "full_name": "Doretta Johnston",
        "full_name_with_team": "[Franecki, Harvey and Heller] Doretta Johnston",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-13T18:10:49.016-08:00",
        "created_at": "2026-02-13T18:10:49.016-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "863aad20-5a4f-46fa-9b95-5bde4c8f7038",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "cadafd0f-a014-49a2-862d-ca71a3b5e30a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "de8fc2c9-3d96-4721-8295-b46283d77b66",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "b5c22253-83b5-4264-9331-d3bde3dcd8d5",
              "type": "user_notification_rules"
            },
            {
              "id": "e09ece5f-6078-40ec-b134-8ff54432ffa8",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1159",
      "type": "users",
      "attributes": {
        "name": "Man Hand",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Man",
        "last_name": "Hand",
        "full_name": "Man Hand",
        "full_name_with_team": "[Franecki, Harvey and Heller] Man Hand",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-13T18:10:48.962-08:00",
        "created_at": "2026-02-13T18:10:48.962-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "efa242a9-36fd-4c97-8c4f-4f964c26fabe",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "cadafd0f-a014-49a2-862d-ca71a3b5e30a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "de8fc2c9-3d96-4721-8295-b46283d77b66",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "5f9389a0-581b-402e-a6d0-813f92b040d4",
              "type": "user_notification_rules"
            },
            {
              "id": "458a0707-161d-460f-930c-a793dacef5be",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1158",
      "type": "users",
      "attributes": {
        "name": "Laurence Jenkins",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Laurence",
        "last_name": "Jenkins",
        "full_name": "Laurence Jenkins",
        "full_name_with_team": "[Franecki, Harvey and Heller] Laurence Jenkins",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-13T18:10:48.902-08:00",
        "created_at": "2026-02-13T18:10:48.902-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "43a2a8c4-f63e-4d4e-bd89-efd707b36014",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "cadafd0f-a014-49a2-862d-ca71a3b5e30a",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "de8fc2c9-3d96-4721-8295-b46283d77b66",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "c2c2e4b5-9800-4186-866c-ee1b2037242f",
              "type": "user_notification_rules"
            },
            {
              "id": "1e7d24af-c0c8-4ad4-b086-d9df2ca9e64d",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1157",
      "type": "users",
      "attributes": {
        "name": "Derick Christiansen",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Derick",
        "last_name": "Christiansen",
        "full_name": "Derick Christiansen",
        "full_name_with_team": "[Franecki, Harvey and Heller] Derick Christiansen",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-13T18:10:48.899-08:00",
        "created_at": "2026-02-13T18:10:48.677-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "bf720ce6-f673-498d-b0b5-4acb3ec7407c",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c4d9d437-adb3-4100-8301-40bde7b5374b",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "de8fc2c9-3d96-4721-8295-b46283d77b66",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "0eeff2da-e136-40a7-ade5-b904fc158124",
              "type": "user_notification_rules"
            },
            {
              "id": "6ef12db1-9809-4953-bf07-57f78d5332f9",
              "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