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": "Willene Lakin",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Willene",
        "last_name": "Lakin",
        "full_name": "Willene Lakin",
        "full_name_with_team": "[Klein-Ritchie] Willene Lakin",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T18:29:35.693-08:00",
        "created_at": "2026-02-06T18:29:35.693-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "35e9cc50-a4ff-4d17-bc44-844f9cb09274",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "4a3e0a85-4f5c-4e41-bc81-f1a204728183",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7e5db5d9-fc67-456e-8aa0-791c939b4771",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "bfa9cae6-fbea-4e80-b5ca-f521f76b53a0",
              "type": "user_notification_rules"
            },
            {
              "id": "2ecf89a3-57b3-4d47-9a8c-d4369f571dd7",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1071",
      "type": "users",
      "attributes": {
        "name": "Herb McKenzie",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Herb",
        "last_name": "McKenzie",
        "full_name": "Herb McKenzie",
        "full_name_with_team": "[Klein-Ritchie] Herb McKenzie",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T18:29:35.613-08:00",
        "created_at": "2026-02-06T18:29:35.613-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "90aebf39-f986-43a8-8611-b5baa6b16981",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b809d391-e70e-4a04-9ff3-dcc1a7a2b5d0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7e5db5d9-fc67-456e-8aa0-791c939b4771",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "6ea56ec0-2626-4c1d-8d75-d9af80e8cce6",
              "type": "user_notification_rules"
            },
            {
              "id": "1a9d819c-1d2f-40ed-94f0-abfbcaa579be",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1070",
      "type": "users",
      "attributes": {
        "name": "Anita Bailey",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Anita",
        "last_name": "Bailey",
        "full_name": "Anita Bailey",
        "full_name_with_team": "[Klein-Ritchie] Anita Bailey",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T18:29:35.513-08:00",
        "created_at": "2026-02-06T18:29:35.513-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "f47814ed-7af2-43d3-af25-d590029d4e0f",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e3db04dd-bf7d-4520-b66a-c671b726c4d7",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7e5db5d9-fc67-456e-8aa0-791c939b4771",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "3d445696-bb8e-4bac-b7df-9ee4a598d983",
              "type": "user_notification_rules"
            },
            {
              "id": "1fdfed3f-d8ce-4a0e-bb3c-f91c2de0585e",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1068",
      "type": "users",
      "attributes": {
        "name": "Magaly Larson",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Magaly",
        "last_name": "Larson",
        "full_name": "Magaly Larson",
        "full_name_with_team": "[Klein-Ritchie] Magaly Larson",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T18:29:35.162-08:00",
        "created_at": "2026-02-06T18:29:35.162-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "c6e69ba0-7f14-4569-b082-1e6dd98c1623",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b809d391-e70e-4a04-9ff3-dcc1a7a2b5d0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7e5db5d9-fc67-456e-8aa0-791c939b4771",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "b8dfd1a4-2c2a-4267-8c71-a54d2130d451",
              "type": "user_notification_rules"
            },
            {
              "id": "323dbc03-2b98-448d-bace-f396aee352e3",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1067",
      "type": "users",
      "attributes": {
        "name": "Elisha Kshlerin",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Elisha",
        "last_name": "Kshlerin",
        "full_name": "Elisha Kshlerin",
        "full_name_with_team": "[Klein-Ritchie] Elisha Kshlerin",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T18:29:35.093-08:00",
        "created_at": "2026-02-06T18:29:35.093-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "79768c0d-83ab-4823-9931-d5b97044982c",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b809d391-e70e-4a04-9ff3-dcc1a7a2b5d0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7e5db5d9-fc67-456e-8aa0-791c939b4771",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "1467ed9d-0842-40d6-9fc4-950212f32e05",
              "type": "user_notification_rules"
            },
            {
              "id": "e541fdc2-2a23-492c-aa5a-9e3abf2dbe28",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1066",
      "type": "users",
      "attributes": {
        "name": "America Parker",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "America",
        "last_name": "Parker",
        "full_name": "America Parker",
        "full_name_with_team": "[Klein-Ritchie] America Parker",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T18:29:34.986-08:00",
        "created_at": "2026-02-06T18:29:34.986-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "f03fd967-0bd1-4f8a-985c-9516777a3107",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b809d391-e70e-4a04-9ff3-dcc1a7a2b5d0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7e5db5d9-fc67-456e-8aa0-791c939b4771",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "d9f9a66d-d50a-4708-a462-3328c9656346",
              "type": "user_notification_rules"
            },
            {
              "id": "5ba00334-15ca-4d14-9249-71a6803b57e8",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1065",
      "type": "users",
      "attributes": {
        "name": "Celinda Considine",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Celinda",
        "last_name": "Considine",
        "full_name": "Celinda Considine",
        "full_name_with_team": "[Klein-Ritchie] Celinda Considine",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T18:29:34.913-08:00",
        "created_at": "2026-02-06T18:29:34.913-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "35eb8e0f-a0d7-495e-916b-bb19e0fd1656",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b809d391-e70e-4a04-9ff3-dcc1a7a2b5d0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7e5db5d9-fc67-456e-8aa0-791c939b4771",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "b26af863-186c-4557-b0b5-de4af1b557b3",
              "type": "user_notification_rules"
            },
            {
              "id": "0d2d0b94-2dd3-4ce9-bf25-2611cb000b50",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1064",
      "type": "users",
      "attributes": {
        "name": "Joaquina White",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Joaquina",
        "last_name": "White",
        "full_name": "Joaquina White",
        "full_name_with_team": "[Klein-Ritchie] Joaquina White",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T18:29:34.844-08:00",
        "created_at": "2026-02-06T18:29:34.844-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "eb9c3a9b-be55-43c9-bd60-a5ecacb4dd2b",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b809d391-e70e-4a04-9ff3-dcc1a7a2b5d0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7e5db5d9-fc67-456e-8aa0-791c939b4771",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "5a92bdde-17f6-431e-bddd-972c9acb827f",
              "type": "user_notification_rules"
            },
            {
              "id": "a95e0969-ea39-4c74-be5a-e3792eff0c34",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1063",
      "type": "users",
      "attributes": {
        "name": "Myrtice Dare",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Myrtice",
        "last_name": "Dare",
        "full_name": "Myrtice Dare",
        "full_name_with_team": "[Klein-Ritchie] Myrtice Dare",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T18:29:34.780-08:00",
        "created_at": "2026-02-06T18:29:34.780-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "9232022c-2885-455e-af7c-32830393c1b7",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b809d391-e70e-4a04-9ff3-dcc1a7a2b5d0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7e5db5d9-fc67-456e-8aa0-791c939b4771",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "405669c2-0da7-4571-ae69-9f2beb64c591",
              "type": "user_notification_rules"
            },
            {
              "id": "1a6d3615-31e3-4369-bb65-6228eb4214e9",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1062",
      "type": "users",
      "attributes": {
        "name": "Loreta Hane",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Loreta",
        "last_name": "Hane",
        "full_name": "Loreta Hane",
        "full_name_with_team": "[Klein-Ritchie] Loreta Hane",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T18:29:34.710-08:00",
        "created_at": "2026-02-06T18:29:34.710-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "dcbe2b54-91d9-4bc8-adff-41e2904d5be1",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b809d391-e70e-4a04-9ff3-dcc1a7a2b5d0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7e5db5d9-fc67-456e-8aa0-791c939b4771",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "11164851-3be4-4034-8c5e-f9cd64e54d67",
              "type": "user_notification_rules"
            },
            {
              "id": "525fc06b-77ce-4ca8-8ea5-24d046f8cf3c",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1061",
      "type": "users",
      "attributes": {
        "name": "Jarod Hilpert",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Jarod",
        "last_name": "Hilpert",
        "full_name": "Jarod Hilpert",
        "full_name_with_team": "[Klein-Ritchie] Jarod Hilpert",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T18:29:34.642-08:00",
        "created_at": "2026-02-06T18:29:34.642-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "27ab7207-822d-4c96-ae94-c0d1f590d42a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b809d391-e70e-4a04-9ff3-dcc1a7a2b5d0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7e5db5d9-fc67-456e-8aa0-791c939b4771",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "c13af2ce-42b3-4da7-8480-23c545ddd8dd",
              "type": "user_notification_rules"
            },
            {
              "id": "d5ce0e16-c43a-4c5c-848b-b1c01aec155c",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1060",
      "type": "users",
      "attributes": {
        "name": "Joleen Simonis",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Joleen",
        "last_name": "Simonis",
        "full_name": "Joleen Simonis",
        "full_name_with_team": "[Klein-Ritchie] Joleen Simonis",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T18:29:34.575-08:00",
        "created_at": "2026-02-06T18:29:34.575-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "a7b72213-f46e-4cfd-aa34-2f63ab8b6637",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b809d391-e70e-4a04-9ff3-dcc1a7a2b5d0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7e5db5d9-fc67-456e-8aa0-791c939b4771",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "106c7872-d97c-4c50-84db-6d956465cd29",
              "type": "user_notification_rules"
            },
            {
              "id": "62f3912c-c1d0-4f3b-9ab5-190efd57f9a8",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1059",
      "type": "users",
      "attributes": {
        "name": "Arlen Reinger",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Arlen",
        "last_name": "Reinger",
        "full_name": "Arlen Reinger",
        "full_name_with_team": "[Klein-Ritchie] Arlen Reinger",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T18:29:34.571-08:00",
        "created_at": "2026-02-06T18:29:34.305-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "737f3904-898c-4e3b-b023-a4cb6f6768c4",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "e3db04dd-bf7d-4520-b66a-c671b726c4d7",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "7e5db5d9-fc67-456e-8aa0-791c939b4771",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "98d6fa77-a20c-4c0a-a62d-6e26ece5ae64",
              "type": "user_notification_rules"
            },
            {
              "id": "5fc06064-0b49-4ef4-8165-24e16607a9a4",
              "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