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": "556",
      "type": "users",
      "attributes": {
        "name": "Edgar Casper",
        "email": "numbers_bode@ondricka.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Edgar",
        "last_name": "Casper",
        "full_name": "Edgar Casper",
        "full_name_with_team": "[Rice, Konopelski and Ritchie] Edgar Casper",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-07T17:17:57.607-07:00",
        "created_at": "2025-10-07T17:17:57.607-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "b744fb6c-7229-4520-9776-664d67f0a2aa",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "60bd4dab-cf44-403e-9823-d933dcfca28d",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8ed88a53-7168-4c96-b12e-26116ead4b0f",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "555",
      "type": "users",
      "attributes": {
        "name": "Omer Schaden",
        "email": "kendall@hermann.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Omer",
        "last_name": "Schaden",
        "full_name": "Omer Schaden",
        "full_name_with_team": "[Rice, Konopelski and Ritchie] Omer Schaden",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-07T17:17:57.432-07:00",
        "created_at": "2025-10-07T17:17:57.432-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "c304ae7f-364d-4ce3-bf48-c541ce27cf1c",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c64475fc-2c16-4665-9a13-34fd2cd8d595",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8ed88a53-7168-4c96-b12e-26116ead4b0f",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "554",
      "type": "users",
      "attributes": {
        "name": "Kathrine Metz",
        "email": "annita@ebert-kunze.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Kathrine",
        "last_name": "Metz",
        "full_name": "Kathrine Metz",
        "full_name_with_team": "[Rice, Konopelski and Ritchie] Kathrine Metz",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-07T17:17:57.220-07:00",
        "created_at": "2025-10-07T17:17:57.220-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "162e1691-2df8-4165-a223-f7b9ab1309c9",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b0922b20-ff8f-4851-9c18-5483c093fc2b",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8ed88a53-7168-4c96-b12e-26116ead4b0f",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "552",
      "type": "users",
      "attributes": {
        "name": "Tijuana Ernser",
        "email": "joey.howe@larson.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Tijuana",
        "last_name": "Ernser",
        "full_name": "Tijuana Ernser",
        "full_name_with_team": "[Rice, Konopelski and Ritchie] Tijuana Ernser",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-07T17:17:56.495-07:00",
        "created_at": "2025-10-07T17:17:56.495-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "e91d6b11-3d4f-48be-89d0-b56bee5dc309",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c64475fc-2c16-4665-9a13-34fd2cd8d595",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8ed88a53-7168-4c96-b12e-26116ead4b0f",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "551",
      "type": "users",
      "attributes": {
        "name": "Ellena Hayes",
        "email": "lynetta_dickinson@yundt.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Ellena",
        "last_name": "Hayes",
        "full_name": "Ellena Hayes",
        "full_name_with_team": "[Rice, Konopelski and Ritchie] Ellena Hayes",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-07T17:17:56.362-07:00",
        "created_at": "2025-10-07T17:17:56.362-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "3c96d99e-12f4-4865-a1b1-0736dc5d51d8",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c64475fc-2c16-4665-9a13-34fd2cd8d595",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8ed88a53-7168-4c96-b12e-26116ead4b0f",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "550",
      "type": "users",
      "attributes": {
        "name": "Fermin Vandervort",
        "email": "ira@botsford-crooks.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Fermin",
        "last_name": "Vandervort",
        "full_name": "Fermin Vandervort",
        "full_name_with_team": "[Rice, Konopelski and Ritchie] Fermin Vandervort",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-07T17:17:56.233-07:00",
        "created_at": "2025-10-07T17:17:56.233-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "70e02885-9ea2-4369-a73f-f122a51dc1c5",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c64475fc-2c16-4665-9a13-34fd2cd8d595",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8ed88a53-7168-4c96-b12e-26116ead4b0f",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "549",
      "type": "users",
      "attributes": {
        "name": "Tamara Hirthe",
        "email": "brenton@haley.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Tamara",
        "last_name": "Hirthe",
        "full_name": "Tamara Hirthe",
        "full_name_with_team": "[Rice, Konopelski and Ritchie] Tamara Hirthe",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-07T17:17:56.070-07:00",
        "created_at": "2025-10-07T17:17:56.070-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "6210f947-c310-4736-a380-cb55baf45f2a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c64475fc-2c16-4665-9a13-34fd2cd8d595",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8ed88a53-7168-4c96-b12e-26116ead4b0f",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "548",
      "type": "users",
      "attributes": {
        "name": "Chang Haley",
        "email": "brenton_jacobi@cruickshank-schoen.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Chang",
        "last_name": "Haley",
        "full_name": "Chang Haley",
        "full_name_with_team": "[Rice, Konopelski and Ritchie] Chang Haley",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-07T17:17:55.914-07:00",
        "created_at": "2025-10-07T17:17:55.914-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "3e8969b2-fd07-415f-aa22-ca5b7358d0fe",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c64475fc-2c16-4665-9a13-34fd2cd8d595",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8ed88a53-7168-4c96-b12e-26116ead4b0f",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "547",
      "type": "users",
      "attributes": {
        "name": "Francesca O'Kon",
        "email": "laurena@oconnell-mitchell.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Francesca",
        "last_name": "O'Kon",
        "full_name": "Francesca O'Kon",
        "full_name_with_team": "[Rice, Konopelski and Ritchie] Francesca O'Kon",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-07T17:17:55.766-07:00",
        "created_at": "2025-10-07T17:17:55.766-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "c3e964de-7554-4d83-8766-5f43764381aa",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c64475fc-2c16-4665-9a13-34fd2cd8d595",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8ed88a53-7168-4c96-b12e-26116ead4b0f",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "546",
      "type": "users",
      "attributes": {
        "name": "Ahmed Gutmann",
        "email": "robbin.homenick@gislason-crist.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Ahmed",
        "last_name": "Gutmann",
        "full_name": "Ahmed Gutmann",
        "full_name_with_team": "[Rice, Konopelski and Ritchie] Ahmed Gutmann",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-07T17:17:55.582-07:00",
        "created_at": "2025-10-07T17:17:55.582-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "aa8ad426-5e4a-451a-80da-02839038db72",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c64475fc-2c16-4665-9a13-34fd2cd8d595",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8ed88a53-7168-4c96-b12e-26116ead4b0f",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "545",
      "type": "users",
      "attributes": {
        "name": "Dominique Weimann",
        "email": "alena.little@veum.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Dominique",
        "last_name": "Weimann",
        "full_name": "Dominique Weimann",
        "full_name_with_team": "[Rice, Konopelski and Ritchie] Dominique Weimann",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-07T17:17:55.389-07:00",
        "created_at": "2025-10-07T17:17:55.389-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "2996b504-f4ab-4e37-bf63-53018cb1b73d",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c64475fc-2c16-4665-9a13-34fd2cd8d595",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8ed88a53-7168-4c96-b12e-26116ead4b0f",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "544",
      "type": "users",
      "attributes": {
        "name": "Rafael Larson",
        "email": "young_kutch@brown.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Rafael",
        "last_name": "Larson",
        "full_name": "Rafael Larson",
        "full_name_with_team": "[Rice, Konopelski and Ritchie] Rafael Larson",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-07T17:17:55.246-07:00",
        "created_at": "2025-10-07T17:17:55.246-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "789ed779-46bb-4d14-b3cd-734a224a1352",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c64475fc-2c16-4665-9a13-34fd2cd8d595",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8ed88a53-7168-4c96-b12e-26116ead4b0f",
            "type": "on_call_roles"
          }
        }
      }
    },
    {
      "id": "543",
      "type": "users",
      "attributes": {
        "name": "Tyron Cartwright",
        "email": "darius.kuhlman@rosenbaum-lubowitz.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Tyron",
        "last_name": "Cartwright",
        "full_name": "Tyron Cartwright",
        "full_name_with_team": "[Rice, Konopelski and Ritchie] Tyron Cartwright",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-10-07T17:17:55.237-07:00",
        "created_at": "2025-10-07T17:17:54.560-07:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "ff1660b7-ccbe-4d8d-aac1-2db8dc2af2ef",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "b0922b20-ff8f-4851-9c18-5483c093fc2b",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8ed88a53-7168-4c96-b12e-26116ead4b0f",
            "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[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

Response

user found

​
data
object[]
required
​
links
object
required
⌘I