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": "1072",
      "type": "users",
      "attributes": {
        "name": "Dallas Upton",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Dallas",
        "last_name": "Upton",
        "full_name": "Dallas Upton",
        "full_name_with_team": "[Will-Jaskolski] Dallas Upton",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T14:05:57.667-08:00",
        "created_at": "2026-02-03T14:05:57.667-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "bc9c69b1-f386-4ad9-8e40-7dfa1060b168",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "12144cb4-e44b-4275-a63f-7b6ef6147d98",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea609f49-11a4-4480-9b35-96afd7b8a648",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "ef876f1e-a4a1-4f40-9e9a-dcec523d9ba1",
              "type": "user_notification_rules"
            },
            {
              "id": "8ee39ae0-978e-4823-828e-fa0d2343bde9",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1071",
      "type": "users",
      "attributes": {
        "name": "Dalila Murphy",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Dalila",
        "last_name": "Murphy",
        "full_name": "Dalila Murphy",
        "full_name_with_team": "[Will-Jaskolski] Dalila Murphy",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T14:05:57.583-08:00",
        "created_at": "2026-02-03T14:05:57.583-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "693c81de-2476-4da4-88be-30df58bb6422",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "270e478c-8d67-452c-b390-04c1941f5644",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea609f49-11a4-4480-9b35-96afd7b8a648",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "5de1aae7-e4e8-4100-92c6-8a8067d8c42e",
              "type": "user_notification_rules"
            },
            {
              "id": "47e5f0ba-dba0-4152-a406-3fefb7de77b0",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1070",
      "type": "users",
      "attributes": {
        "name": "Andre Kemmer",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Andre",
        "last_name": "Kemmer",
        "full_name": "Andre Kemmer",
        "full_name_with_team": "[Will-Jaskolski] Andre Kemmer",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T14:05:57.412-08:00",
        "created_at": "2026-02-03T14:05:57.412-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "103c3080-ad6b-498b-9623-447888e112ee",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0b71f951-534f-44de-bffb-c5a059ce6b48",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea609f49-11a4-4480-9b35-96afd7b8a648",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "7cb657ae-ff7c-4715-88df-e06082eec7e8",
              "type": "user_notification_rules"
            },
            {
              "id": "98342bb3-9c3a-4c4e-8293-6bf834bd3c9f",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1068",
      "type": "users",
      "attributes": {
        "name": "Priscila Koepp",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Priscila",
        "last_name": "Koepp",
        "full_name": "Priscila Koepp",
        "full_name_with_team": "[Will-Jaskolski] Priscila Koepp",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T14:05:56.983-08:00",
        "created_at": "2026-02-03T14:05:56.982-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "cdf01924-67a1-4610-b1e6-ee9244e30221",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "270e478c-8d67-452c-b390-04c1941f5644",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea609f49-11a4-4480-9b35-96afd7b8a648",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "5c559f5a-c0da-4ff9-b84e-3b5d5c2b3a7a",
              "type": "user_notification_rules"
            },
            {
              "id": "ed51c607-e38b-42be-9fb9-1badc1aaa4a0",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1067",
      "type": "users",
      "attributes": {
        "name": "Virgil Smith",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Virgil",
        "last_name": "Smith",
        "full_name": "Virgil Smith",
        "full_name_with_team": "[Will-Jaskolski] Virgil Smith",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T14:05:56.912-08:00",
        "created_at": "2026-02-03T14:05:56.912-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "51b3d3c0-ad22-41f9-9395-38f0caff7054",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "270e478c-8d67-452c-b390-04c1941f5644",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea609f49-11a4-4480-9b35-96afd7b8a648",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "213a1843-fa60-4e08-a828-08eeeb896258",
              "type": "user_notification_rules"
            },
            {
              "id": "aa9dcfbe-4b61-4df6-aa92-99382b8cb6d1",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1066",
      "type": "users",
      "attributes": {
        "name": "Shan Braun",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Shan",
        "last_name": "Braun",
        "full_name": "Shan Braun",
        "full_name_with_team": "[Will-Jaskolski] Shan Braun",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T14:05:56.845-08:00",
        "created_at": "2026-02-03T14:05:56.845-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "1888a0de-3edb-4ef9-b27e-38d1878726cd",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "270e478c-8d67-452c-b390-04c1941f5644",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea609f49-11a4-4480-9b35-96afd7b8a648",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "a1b499d3-75b0-47cc-b34c-e08509f75bb5",
              "type": "user_notification_rules"
            },
            {
              "id": "e6c9ceb5-0fc2-4941-9fbb-e8b122277196",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1065",
      "type": "users",
      "attributes": {
        "name": "Doreatha Satterfield",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Doreatha",
        "last_name": "Satterfield",
        "full_name": "Doreatha Satterfield",
        "full_name_with_team": "[Will-Jaskolski] Doreatha Satterfield",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T14:05:56.769-08:00",
        "created_at": "2026-02-03T14:05:56.769-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "642f03d4-e4fd-4e96-a169-650eef285979",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "270e478c-8d67-452c-b390-04c1941f5644",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea609f49-11a4-4480-9b35-96afd7b8a648",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "021986a0-72c2-465e-ab50-879727907d27",
              "type": "user_notification_rules"
            },
            {
              "id": "b5fa1db0-cbb0-40fb-81d6-04a559450594",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1064",
      "type": "users",
      "attributes": {
        "name": "Enoch Bode",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Enoch",
        "last_name": "Bode",
        "full_name": "Enoch Bode",
        "full_name_with_team": "[Will-Jaskolski] Enoch Bode",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T14:05:56.651-08:00",
        "created_at": "2026-02-03T14:05:56.651-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "c5b13213-4596-4775-b104-ee8cf80000ea",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "270e478c-8d67-452c-b390-04c1941f5644",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea609f49-11a4-4480-9b35-96afd7b8a648",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "27510350-4592-44a4-8bb6-ee320e14da8b",
              "type": "user_notification_rules"
            },
            {
              "id": "1318401c-d5d7-45ff-b838-a99ee070b5ee",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1063",
      "type": "users",
      "attributes": {
        "name": "Rozella Johnson",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Rozella",
        "last_name": "Johnson",
        "full_name": "Rozella Johnson",
        "full_name_with_team": "[Will-Jaskolski] Rozella Johnson",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T14:05:56.579-08:00",
        "created_at": "2026-02-03T14:05:56.579-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "048fc109-e47c-40e7-b5bd-d875693eac5d",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "270e478c-8d67-452c-b390-04c1941f5644",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea609f49-11a4-4480-9b35-96afd7b8a648",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "323bfaa7-57fe-4815-af0a-a01442c358e7",
              "type": "user_notification_rules"
            },
            {
              "id": "2b094fc7-19d2-4d33-ac81-3ed3765a5357",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1062",
      "type": "users",
      "attributes": {
        "name": "Shantelle McClure",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Shantelle",
        "last_name": "McClure",
        "full_name": "Shantelle McClure",
        "full_name_with_team": "[Will-Jaskolski] Shantelle McClure",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T14:05:56.509-08:00",
        "created_at": "2026-02-03T14:05:56.509-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "142a7c1c-bd4d-42f2-a749-aa94f40940b1",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "270e478c-8d67-452c-b390-04c1941f5644",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea609f49-11a4-4480-9b35-96afd7b8a648",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "bb14f13f-fd9b-4846-9f39-5067be4c913e",
              "type": "user_notification_rules"
            },
            {
              "id": "2865a978-cacd-4688-9ff6-ddd6c38697fa",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1061",
      "type": "users",
      "attributes": {
        "name": "Leora Weber",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Leora",
        "last_name": "Weber",
        "full_name": "Leora Weber",
        "full_name_with_team": "[Will-Jaskolski] Leora Weber",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T14:05:56.439-08:00",
        "created_at": "2026-02-03T14:05:56.439-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "02f1bbc3-daa9-4cb3-8736-b912587f7fcd",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "270e478c-8d67-452c-b390-04c1941f5644",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea609f49-11a4-4480-9b35-96afd7b8a648",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "deaa4f63-ccee-41b6-a313-44ddf1c3ff51",
              "type": "user_notification_rules"
            },
            {
              "id": "177c1036-ef40-4fca-bf67-57308433511f",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1060",
      "type": "users",
      "attributes": {
        "name": "Kirk Fahey",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Kirk",
        "last_name": "Fahey",
        "full_name": "Kirk Fahey",
        "full_name_with_team": "[Will-Jaskolski] Kirk Fahey",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T14:05:56.370-08:00",
        "created_at": "2026-02-03T14:05:56.370-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "ebfb9cc0-5371-4b9c-968a-7c48512ead05",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "270e478c-8d67-452c-b390-04c1941f5644",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea609f49-11a4-4480-9b35-96afd7b8a648",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "0df77440-ac6a-45b9-90cf-9d79edf38a26",
              "type": "user_notification_rules"
            },
            {
              "id": "db35d802-4ad3-4c92-a60e-8d8fb9a3c963",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1059",
      "type": "users",
      "attributes": {
        "name": "Jo Pacocha",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Jo",
        "last_name": "Pacocha",
        "full_name": "Jo Pacocha",
        "full_name_with_team": "[Will-Jaskolski] Jo Pacocha",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T14:05:56.365-08:00",
        "created_at": "2026-02-03T14:05:56.013-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "8bb96612-7f45-4109-a3e6-9a1587446df9",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0b71f951-534f-44de-bffb-c5a059ce6b48",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea609f49-11a4-4480-9b35-96afd7b8a648",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "5026d2cc-bf65-4e7e-995a-fe805b817bb9",
              "type": "user_notification_rules"
            },
            {
              "id": "c4783c82-6832-4d3e-8ff7-f74a01bcabeb",
              "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