GET
/
v1
/
users
List users
curl --request GET \
  --url https://api.rootly.com/v1/users \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "514",
      "type": "users",
      "attributes": {
        "name": "Raphael Cormier",
        "email": "mack@konopelski.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Raphael",
        "last_name": "Cormier",
        "full_name": "Raphael Cormier",
        "full_name_with_team": "[Ruecker, Schuster and Metz] Raphael Cormier",
        "slack_id": null,
        "time_zone": "UTC",
        "updated_at": "2025-08-19T10:26:10.728-07:00",
        "created_at": "2025-08-19T10:26:10.728-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "6a6657a7-2f47-4308-be32-8f9b7857326c",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d4cf68c8-6e00-46c6-bf79-c3d2888d81d0",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e918551-63f1-4f03-8493-be89217c205b",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "513",
      "type": "users",
      "attributes": {
        "name": "Jeanne Hettinger",
        "email": "dudley.bechtelar@heidenreich.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Jeanne",
        "last_name": "Hettinger",
        "full_name": "Jeanne Hettinger",
        "full_name_with_team": "[Ruecker, Schuster and Metz] Jeanne Hettinger",
        "slack_id": null,
        "time_zone": "UTC",
        "updated_at": "2025-08-19T10:26:10.616-07:00",
        "created_at": "2025-08-19T10:26:10.616-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "80b717cf-6bd9-4fc5-9a7c-37deea5843a7",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "7e0f86b7-65e8-4f74-afd6-3f6c1f5355b9",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e918551-63f1-4f03-8493-be89217c205b",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "512",
      "type": "users",
      "attributes": {
        "name": "Charlie Boyer",
        "email": "giovanni_hartmann@oconnell.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Charlie",
        "last_name": "Boyer",
        "full_name": "Charlie Boyer",
        "full_name_with_team": "[Ruecker, Schuster and Metz] Charlie Boyer",
        "slack_id": null,
        "time_zone": "UTC",
        "updated_at": "2025-08-19T10:26:10.438-07:00",
        "created_at": "2025-08-19T10:26:10.438-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "1d39f417-6e9c-43fc-9f06-6cfbcaee2278",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "269097be-f161-4c96-8eef-dc4a342b31a8",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e918551-63f1-4f03-8493-be89217c205b",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "510",
      "type": "users",
      "attributes": {
        "name": "Awilda Homenick",
        "email": "debra@corkery.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Awilda",
        "last_name": "Homenick",
        "full_name": "Awilda Homenick",
        "full_name_with_team": "[Ruecker, Schuster and Metz] Awilda Homenick",
        "slack_id": null,
        "time_zone": "UTC",
        "updated_at": "2025-08-19T10:26:09.953-07:00",
        "created_at": "2025-08-19T10:26:09.953-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "ec3e7931-786d-4ee5-925e-d3bc47f69304",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "7e0f86b7-65e8-4f74-afd6-3f6c1f5355b9",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e918551-63f1-4f03-8493-be89217c205b",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "509",
      "type": "users",
      "attributes": {
        "name": "Latashia Carroll",
        "email": "mattie_swaniawski@damore.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Latashia",
        "last_name": "Carroll",
        "full_name": "Latashia Carroll",
        "full_name_with_team": "[Ruecker, Schuster and Metz] Latashia Carroll",
        "slack_id": null,
        "time_zone": "UTC",
        "updated_at": "2025-08-19T10:26:09.863-07:00",
        "created_at": "2025-08-19T10:26:09.863-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "e4a482f8-c9ed-4b23-acaf-f386bec0817e",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "7e0f86b7-65e8-4f74-afd6-3f6c1f5355b9",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e918551-63f1-4f03-8493-be89217c205b",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "508",
      "type": "users",
      "attributes": {
        "name": "Petra Lehner",
        "email": "nada@parker-hansen.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Petra",
        "last_name": "Lehner",
        "full_name": "Petra Lehner",
        "full_name_with_team": "[Ruecker, Schuster and Metz] Petra Lehner",
        "slack_id": null,
        "time_zone": "UTC",
        "updated_at": "2025-08-19T10:26:09.767-07:00",
        "created_at": "2025-08-19T10:26:09.767-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "5535b57a-500d-4c00-b882-97262f5b4999",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "7e0f86b7-65e8-4f74-afd6-3f6c1f5355b9",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e918551-63f1-4f03-8493-be89217c205b",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "507",
      "type": "users",
      "attributes": {
        "name": "Reinaldo Jacobs",
        "email": "mayme@zemlak.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Reinaldo",
        "last_name": "Jacobs",
        "full_name": "Reinaldo Jacobs",
        "full_name_with_team": "[Ruecker, Schuster and Metz] Reinaldo Jacobs",
        "slack_id": null,
        "time_zone": "UTC",
        "updated_at": "2025-08-19T10:26:09.660-07:00",
        "created_at": "2025-08-19T10:26:09.660-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "f53331d7-dc67-4fd1-b0d0-987acef886ba",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "7e0f86b7-65e8-4f74-afd6-3f6c1f5355b9",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e918551-63f1-4f03-8493-be89217c205b",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "506",
      "type": "users",
      "attributes": {
        "name": "Christoper Ruecker",
        "email": "sheree@smitham.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Christoper",
        "last_name": "Ruecker",
        "full_name": "Christoper Ruecker",
        "full_name_with_team": "[Ruecker, Schuster and Metz] Christoper Ruecker",
        "slack_id": null,
        "time_zone": "UTC",
        "updated_at": "2025-08-19T10:26:09.544-07:00",
        "created_at": "2025-08-19T10:26:09.544-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "d9342755-c8f0-40de-bdbf-614ccad62904",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "7e0f86b7-65e8-4f74-afd6-3f6c1f5355b9",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e918551-63f1-4f03-8493-be89217c205b",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "505",
      "type": "users",
      "attributes": {
        "name": "Tamera Ritchie",
        "email": "otha@brekke-bashirian.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Tamera",
        "last_name": "Ritchie",
        "full_name": "Tamera Ritchie",
        "full_name_with_team": "[Ruecker, Schuster and Metz] Tamera Ritchie",
        "slack_id": null,
        "time_zone": "UTC",
        "updated_at": "2025-08-19T10:26:09.433-07:00",
        "created_at": "2025-08-19T10:26:09.433-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "6b62e9cf-f74a-4f00-a794-51544ac6cd02",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "7e0f86b7-65e8-4f74-afd6-3f6c1f5355b9",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e918551-63f1-4f03-8493-be89217c205b",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "504",
      "type": "users",
      "attributes": {
        "name": "Eliseo Brakus",
        "email": "jackson_kunze@swift-crona.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Eliseo",
        "last_name": "Brakus",
        "full_name": "Eliseo Brakus",
        "full_name_with_team": "[Ruecker, Schuster and Metz] Eliseo Brakus",
        "slack_id": null,
        "time_zone": "UTC",
        "updated_at": "2025-08-19T10:26:09.321-07:00",
        "created_at": "2025-08-19T10:26:09.321-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "2e064b8c-ed2b-4525-b2c4-048c4815a108",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "7e0f86b7-65e8-4f74-afd6-3f6c1f5355b9",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e918551-63f1-4f03-8493-be89217c205b",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "503",
      "type": "users",
      "attributes": {
        "name": "Rodney Maggio",
        "email": "eustolia@kling.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Rodney",
        "last_name": "Maggio",
        "full_name": "Rodney Maggio",
        "full_name_with_team": "[Ruecker, Schuster and Metz] Rodney Maggio",
        "slack_id": null,
        "time_zone": "UTC",
        "updated_at": "2025-08-19T10:26:09.204-07:00",
        "created_at": "2025-08-19T10:26:09.204-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "c60352b4-7d79-46c3-aa7b-1aca0f76bd4c",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "7e0f86b7-65e8-4f74-afd6-3f6c1f5355b9",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e918551-63f1-4f03-8493-be89217c205b",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "502",
      "type": "users",
      "attributes": {
        "name": "Nelly Roob",
        "email": "miguel_homenick@kassulke.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Nelly",
        "last_name": "Roob",
        "full_name": "Nelly Roob",
        "full_name_with_team": "[Ruecker, Schuster and Metz] Nelly Roob",
        "slack_id": null,
        "time_zone": "UTC",
        "updated_at": "2025-08-19T10:26:09.084-07:00",
        "created_at": "2025-08-19T10:26:09.084-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "6b07df7a-b052-488a-9249-0d29d1ac8eff",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "7e0f86b7-65e8-4f74-afd6-3f6c1f5355b9",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e918551-63f1-4f03-8493-be89217c205b",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "501",
      "type": "users",
      "attributes": {
        "name": "Vernon Rogahn",
        "email": "leigha@upton.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Vernon",
        "last_name": "Rogahn",
        "full_name": "Vernon Rogahn",
        "full_name_with_team": "[Ruecker, Schuster and Metz] Vernon Rogahn",
        "slack_id": null,
        "time_zone": "UTC",
        "updated_at": "2025-08-19T10:26:09.077-07:00",
        "created_at": "2025-08-19T10:26:08.618-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "2e7aa813-9940-4a08-ba38-7f9f763aa326",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "269097be-f161-4c96-8eef-dc4a342b31a8",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e918551-63f1-4f03-8493-be89217c205b",
            "type": "on_call_roles"
          }
        }
      }
    }
  ],
  "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

Response

200
application/vnd.api+json

user found

The response is of type object.