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": "1070",
      "type": "users",
      "attributes": {
        "name": "Louella Cassin",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Louella",
        "last_name": "Cassin",
        "full_name": "Louella Cassin",
        "full_name_with_team": "[Will-Farrell] Louella Cassin",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-28T10:18:25.902-08:00",
        "created_at": "2026-01-28T10:18:25.902-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "036840ff-f35f-4536-8c5e-ca776a06be37",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "6b4158ae-7eb3-489e-a8f4-1b12915a4486",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "409fcbac-8eb9-4764-a9f8-f2590debd8c5",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "6db48fbe-025d-4743-b14b-513080c74708",
              "type": "user_notification_rules"
            },
            {
              "id": "4f10b2ba-6b05-4f68-9869-0d5c4187b2fc",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1069",
      "type": "users",
      "attributes": {
        "name": "Hank Hickle",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Hank",
        "last_name": "Hickle",
        "full_name": "Hank Hickle",
        "full_name_with_team": "[Will-Farrell] Hank Hickle",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-28T10:18:25.770-08:00",
        "created_at": "2026-01-28T10:18:25.770-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "48757c2d-96ea-4626-a4b7-493ceb70726a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "414e4915-9dfa-40b0-a551-3cc600b3c021",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "409fcbac-8eb9-4764-a9f8-f2590debd8c5",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "78f33c3e-4749-4928-a07f-7ba556c7265f",
              "type": "user_notification_rules"
            },
            {
              "id": "bd68e4a4-3b5d-4722-98be-a88dc48ee203",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1068",
      "type": "users",
      "attributes": {
        "name": "Daryl Sporer",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Daryl",
        "last_name": "Sporer",
        "full_name": "Daryl Sporer",
        "full_name_with_team": "[Will-Farrell] Daryl Sporer",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-28T10:18:25.581-08:00",
        "created_at": "2026-01-28T10:18:25.581-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "3042e92c-d2af-4877-9760-08967683c7c6",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "cb7b24fe-86e8-4982-9ef5-78164bf8571e",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "409fcbac-8eb9-4764-a9f8-f2590debd8c5",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "e64a0ce2-b536-42ac-abe5-3ae08cc67c59",
              "type": "user_notification_rules"
            },
            {
              "id": "6da4eb9b-b614-49cb-81be-534f6cf7b9fd",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1066",
      "type": "users",
      "attributes": {
        "name": "Omer Deckow",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Omer",
        "last_name": "Deckow",
        "full_name": "Omer Deckow",
        "full_name_with_team": "[Will-Farrell] Omer Deckow",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-28T10:18:25.085-08:00",
        "created_at": "2026-01-28T10:18:25.085-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "8a47851e-c62e-45bb-95d9-f82314ce0a78",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "414e4915-9dfa-40b0-a551-3cc600b3c021",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "409fcbac-8eb9-4764-a9f8-f2590debd8c5",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "de7ecafa-7dd1-4e34-a4a1-56be829837b9",
              "type": "user_notification_rules"
            },
            {
              "id": "9a43993e-4ca5-4216-a2b4-8d0480efdc25",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1065",
      "type": "users",
      "attributes": {
        "name": "Mose Hodkiewicz",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Mose",
        "last_name": "Hodkiewicz",
        "full_name": "Mose Hodkiewicz",
        "full_name_with_team": "[Will-Farrell] Mose Hodkiewicz",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-28T10:18:25.000-08:00",
        "created_at": "2026-01-28T10:18:25.000-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "ae6421e7-e9f6-4795-930b-58ba7c079d63",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "414e4915-9dfa-40b0-a551-3cc600b3c021",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "409fcbac-8eb9-4764-a9f8-f2590debd8c5",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "51e0718e-62bc-4caa-b0a1-6924385f454c",
              "type": "user_notification_rules"
            },
            {
              "id": "bfd1ddd9-bb34-4bf5-b4bc-4dd4a1da2d78",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1064",
      "type": "users",
      "attributes": {
        "name": "Horacio Upton",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Horacio",
        "last_name": "Upton",
        "full_name": "Horacio Upton",
        "full_name_with_team": "[Will-Farrell] Horacio Upton",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-28T10:18:24.910-08:00",
        "created_at": "2026-01-28T10:18:24.910-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "6cacbf26-796b-45b0-b491-c428832d04ee",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "414e4915-9dfa-40b0-a551-3cc600b3c021",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "409fcbac-8eb9-4764-a9f8-f2590debd8c5",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "5c4d58eb-54ea-4801-8600-3b8ebfa0897b",
              "type": "user_notification_rules"
            },
            {
              "id": "bf911174-80fb-43c9-9293-82acfcf8b7e8",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1063",
      "type": "users",
      "attributes": {
        "name": "Billi Bogan",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Billi",
        "last_name": "Bogan",
        "full_name": "Billi Bogan",
        "full_name_with_team": "[Will-Farrell] Billi Bogan",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-28T10:18:24.756-08:00",
        "created_at": "2026-01-28T10:18:24.756-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "53a3b4ac-d6c9-4c9f-8d58-78815dec0671",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "414e4915-9dfa-40b0-a551-3cc600b3c021",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "409fcbac-8eb9-4764-a9f8-f2590debd8c5",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "6e7ea3ee-1ff9-428d-bc7e-2aa90162ed1e",
              "type": "user_notification_rules"
            },
            {
              "id": "f8e009e7-0c4f-4052-aab7-aeb6079c9c30",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1062",
      "type": "users",
      "attributes": {
        "name": "Merlin Toy",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Merlin",
        "last_name": "Toy",
        "full_name": "Merlin Toy",
        "full_name_with_team": "[Will-Farrell] Merlin Toy",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-28T10:18:24.649-08:00",
        "created_at": "2026-01-28T10:18:24.649-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "948143ec-2270-463b-ac50-a45d4dea2071",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "414e4915-9dfa-40b0-a551-3cc600b3c021",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "409fcbac-8eb9-4764-a9f8-f2590debd8c5",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "5e22b855-68bb-45fd-82ab-3426d057d1a0",
              "type": "user_notification_rules"
            },
            {
              "id": "2a433a16-9408-4da9-9617-07b51d8c56be",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1061",
      "type": "users",
      "attributes": {
        "name": "Brock Cremin",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Brock",
        "last_name": "Cremin",
        "full_name": "Brock Cremin",
        "full_name_with_team": "[Will-Farrell] Brock Cremin",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-28T10:18:24.536-08:00",
        "created_at": "2026-01-28T10:18:24.536-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "f7cd757e-8473-45b2-9110-3ff8c61ee0de",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "414e4915-9dfa-40b0-a551-3cc600b3c021",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "409fcbac-8eb9-4764-a9f8-f2590debd8c5",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "47530875-10b3-4534-930a-36f2b88e3967",
              "type": "user_notification_rules"
            },
            {
              "id": "f9fba196-1f24-47e5-a03c-2d5bca99e208",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1060",
      "type": "users",
      "attributes": {
        "name": "Terrence Cummerata",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Terrence",
        "last_name": "Cummerata",
        "full_name": "Terrence Cummerata",
        "full_name_with_team": "[Will-Farrell] Terrence Cummerata",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-28T10:18:24.452-08:00",
        "created_at": "2026-01-28T10:18:24.452-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "0363fc27-337a-45fb-8ea9-b26a0e10c9df",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "414e4915-9dfa-40b0-a551-3cc600b3c021",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "409fcbac-8eb9-4764-a9f8-f2590debd8c5",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "ac022951-4c0d-4988-89eb-8da6e1b1de85",
              "type": "user_notification_rules"
            },
            {
              "id": "85e6aacb-cfae-4187-9405-22a25c6ae482",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1059",
      "type": "users",
      "attributes": {
        "name": "Chase Davis",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Chase",
        "last_name": "Davis",
        "full_name": "Chase Davis",
        "full_name_with_team": "[Will-Farrell] Chase Davis",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-28T10:18:24.361-08:00",
        "created_at": "2026-01-28T10:18:24.361-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "5a2725fa-b948-4129-9939-68f97fab1e2a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "414e4915-9dfa-40b0-a551-3cc600b3c021",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "409fcbac-8eb9-4764-a9f8-f2590debd8c5",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "f2265b64-b9c5-43a8-9ee8-d4cd1607c16f",
              "type": "user_notification_rules"
            },
            {
              "id": "22fb5656-41d3-49a1-aaa7-528a7fa6cac0",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1058",
      "type": "users",
      "attributes": {
        "name": "Tonita Grant",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Tonita",
        "last_name": "Grant",
        "full_name": "Tonita Grant",
        "full_name_with_team": "[Will-Farrell] Tonita Grant",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-28T10:18:24.269-08:00",
        "created_at": "2026-01-28T10:18:24.269-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "c5daae38-03ba-4652-ac8a-680067de4796",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "414e4915-9dfa-40b0-a551-3cc600b3c021",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "409fcbac-8eb9-4764-a9f8-f2590debd8c5",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "526f787c-fee8-47b5-ae64-44732fff3dba",
              "type": "user_notification_rules"
            },
            {
              "id": "8ff2347c-cad9-4fd1-93c1-d3f04aa9ba17",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1057",
      "type": "users",
      "attributes": {
        "name": "Garfield Nolan",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Garfield",
        "last_name": "Nolan",
        "full_name": "Garfield Nolan",
        "full_name_with_team": "[Will-Farrell] Garfield Nolan",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-01-28T10:18:24.264-08:00",
        "created_at": "2026-01-28T10:18:23.932-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "602faac4-b75d-43bc-8507-a2f156b5de5b",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "cb7b24fe-86e8-4982-9ef5-78164bf8571e",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "409fcbac-8eb9-4764-a9f8-f2590debd8c5",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "3632bc4d-f260-47c6-94b0-7df175d0a082",
              "type": "user_notification_rules"
            },
            {
              "id": "12745251-15f4-4ad1-9840-6183ba9fe2b8",
              "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