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": "Palmira Schroeder",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Palmira",
        "last_name": "Schroeder",
        "full_name": "Palmira Schroeder",
        "full_name_with_team": "[Wintheiser, Armstrong and Hartmann] Palmira Schroeder",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T02:05:05.072-08:00",
        "created_at": "2026-02-03T02:05:05.072-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "9d4a8b4a-b35c-4e27-884b-213de1a053fb",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "322223f1-51bc-4edf-946b-f6f5a36d1347",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ff7e2441-1037-40a3-bb46-f15cbfa52439",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "2a544cda-b2f5-4471-9ccd-54d6cd86c608",
              "type": "user_notification_rules"
            },
            {
              "id": "ff79bec0-949d-4e00-a18d-d341a8db7fdc",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1071",
      "type": "users",
      "attributes": {
        "name": "Steven Dickens",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Steven",
        "last_name": "Dickens",
        "full_name": "Steven Dickens",
        "full_name_with_team": "[Wintheiser, Armstrong and Hartmann] Steven Dickens",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T02:05:04.997-08:00",
        "created_at": "2026-02-03T02:05:04.997-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "31b1b1b9-f0e5-4a6d-8d1d-4d3aaf60065a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ffbec63c-d85e-422a-bcb9-601376510499",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ff7e2441-1037-40a3-bb46-f15cbfa52439",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "d01a2c80-1cec-4c72-b82b-17e2e2a2a1d9",
              "type": "user_notification_rules"
            },
            {
              "id": "8d748be9-4feb-4ca7-b487-828655d21546",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1070",
      "type": "users",
      "attributes": {
        "name": "Son Purdy",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Son",
        "last_name": "Purdy",
        "full_name": "Son Purdy",
        "full_name_with_team": "[Wintheiser, Armstrong and Hartmann] Son Purdy",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T02:05:04.901-08:00",
        "created_at": "2026-02-03T02:05:04.901-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "14aff3ee-13f5-46d5-adb2-4b421ad686e4",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "8e4324eb-b8fd-4348-8b6a-3e39b8cbd510",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ff7e2441-1037-40a3-bb46-f15cbfa52439",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "088ed9b7-777b-4c57-80df-3df959825ed3",
              "type": "user_notification_rules"
            },
            {
              "id": "0519b487-7243-49bb-9f96-cf376c4c11ac",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1068",
      "type": "users",
      "attributes": {
        "name": "Rico Heidenreich",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Rico",
        "last_name": "Heidenreich",
        "full_name": "Rico Heidenreich",
        "full_name_with_team": "[Wintheiser, Armstrong and Hartmann] Rico Heidenreich",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T02:05:04.550-08:00",
        "created_at": "2026-02-03T02:05:04.550-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "998507e7-f198-4fec-8193-fddcf8398c71",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ffbec63c-d85e-422a-bcb9-601376510499",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ff7e2441-1037-40a3-bb46-f15cbfa52439",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "71188d8d-f14f-4bcd-8e1b-6c169c9ebac0",
              "type": "user_notification_rules"
            },
            {
              "id": "58778d83-c34b-485d-b0bc-b3b0f4f1f97b",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1067",
      "type": "users",
      "attributes": {
        "name": "Rochelle Windler",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Rochelle",
        "last_name": "Windler",
        "full_name": "Rochelle Windler",
        "full_name_with_team": "[Wintheiser, Armstrong and Hartmann] Rochelle Windler",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T02:05:04.474-08:00",
        "created_at": "2026-02-03T02:05:04.474-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "f8c1d3eb-b5bd-4b4e-a098-211578932fbc",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ffbec63c-d85e-422a-bcb9-601376510499",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ff7e2441-1037-40a3-bb46-f15cbfa52439",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "c1c70268-fc32-4db3-93b5-607fbdc02e97",
              "type": "user_notification_rules"
            },
            {
              "id": "3949aea2-7c33-48bc-98ff-4870f2228297",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1066",
      "type": "users",
      "attributes": {
        "name": "Carol Bechtelar",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Carol",
        "last_name": "Bechtelar",
        "full_name": "Carol Bechtelar",
        "full_name_with_team": "[Wintheiser, Armstrong and Hartmann] Carol Bechtelar",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T02:05:04.400-08:00",
        "created_at": "2026-02-03T02:05:04.400-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "4ee6c21a-c154-4d04-b2ad-9fb718da5f13",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ffbec63c-d85e-422a-bcb9-601376510499",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ff7e2441-1037-40a3-bb46-f15cbfa52439",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "d418f609-d6c4-4c4f-8ac9-fc7b6d69d8dd",
              "type": "user_notification_rules"
            },
            {
              "id": "3bbf3492-0c6b-4493-9805-1745429e5b52",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1065",
      "type": "users",
      "attributes": {
        "name": "Larry Bailey",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Larry",
        "last_name": "Bailey",
        "full_name": "Larry Bailey",
        "full_name_with_team": "[Wintheiser, Armstrong and Hartmann] Larry Bailey",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T02:05:04.326-08:00",
        "created_at": "2026-02-03T02:05:04.326-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "7d2549bf-e3ba-40a1-972c-e5f22da20a1b",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ffbec63c-d85e-422a-bcb9-601376510499",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ff7e2441-1037-40a3-bb46-f15cbfa52439",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "c139369b-2df5-46dd-ba25-6b4fb1daf13d",
              "type": "user_notification_rules"
            },
            {
              "id": "82a71523-a72a-4e54-abab-3b8f8f0db756",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1064",
      "type": "users",
      "attributes": {
        "name": "Tabitha Zemlak",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Tabitha",
        "last_name": "Zemlak",
        "full_name": "Tabitha Zemlak",
        "full_name_with_team": "[Wintheiser, Armstrong and Hartmann] Tabitha Zemlak",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T02:05:04.247-08:00",
        "created_at": "2026-02-03T02:05:04.247-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "b5950d17-8fb8-49e8-8d26-d942bf676090",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ffbec63c-d85e-422a-bcb9-601376510499",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ff7e2441-1037-40a3-bb46-f15cbfa52439",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "8350d1cc-ffef-436e-b0a4-66a2357260ee",
              "type": "user_notification_rules"
            },
            {
              "id": "71725a0d-0d50-428a-aaeb-0c1ce497bd89",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1063",
      "type": "users",
      "attributes": {
        "name": "Flo Murazik",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Flo",
        "last_name": "Murazik",
        "full_name": "Flo Murazik",
        "full_name_with_team": "[Wintheiser, Armstrong and Hartmann] Flo Murazik",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T02:05:04.171-08:00",
        "created_at": "2026-02-03T02:05:04.171-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "1985af2b-c2eb-4979-bc2b-f9abf5d07e68",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ffbec63c-d85e-422a-bcb9-601376510499",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ff7e2441-1037-40a3-bb46-f15cbfa52439",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "0a729de3-2f4b-405b-8e4b-8eec79a33259",
              "type": "user_notification_rules"
            },
            {
              "id": "5d7cd392-3fb6-4865-8d1b-b2d603f250f3",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1062",
      "type": "users",
      "attributes": {
        "name": "Brain Hodkiewicz",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Brain",
        "last_name": "Hodkiewicz",
        "full_name": "Brain Hodkiewicz",
        "full_name_with_team": "[Wintheiser, Armstrong and Hartmann] Brain Hodkiewicz",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T02:05:04.099-08:00",
        "created_at": "2026-02-03T02:05:04.099-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "f38fa980-8da3-4f9e-8a6f-99f1a4363190",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ffbec63c-d85e-422a-bcb9-601376510499",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ff7e2441-1037-40a3-bb46-f15cbfa52439",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "c654110e-3be9-4443-8024-2392bec6e335",
              "type": "user_notification_rules"
            },
            {
              "id": "022115fa-73e9-45a0-ac21-e3b741f88cd3",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1061",
      "type": "users",
      "attributes": {
        "name": "Angelia Keebler",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Angelia",
        "last_name": "Keebler",
        "full_name": "Angelia Keebler",
        "full_name_with_team": "[Wintheiser, Armstrong and Hartmann] Angelia Keebler",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T02:05:04.026-08:00",
        "created_at": "2026-02-03T02:05:04.026-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "ff49efaa-9521-4d22-b8b6-06fa349733b6",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ffbec63c-d85e-422a-bcb9-601376510499",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ff7e2441-1037-40a3-bb46-f15cbfa52439",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "3a81689c-106e-45d7-81b7-09bc76a227f2",
              "type": "user_notification_rules"
            },
            {
              "id": "a4dd8251-1346-4d96-8c54-a51c1b5e5f2b",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1060",
      "type": "users",
      "attributes": {
        "name": "Annamaria Price",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Annamaria",
        "last_name": "Price",
        "full_name": "Annamaria Price",
        "full_name_with_team": "[Wintheiser, Armstrong and Hartmann] Annamaria Price",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T02:05:03.952-08:00",
        "created_at": "2026-02-03T02:05:03.952-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "97baf30e-9269-406d-b077-0297ffcbb27f",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ffbec63c-d85e-422a-bcb9-601376510499",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ff7e2441-1037-40a3-bb46-f15cbfa52439",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "e2855bb9-252b-451a-a602-82c0ace221d1",
              "type": "user_notification_rules"
            },
            {
              "id": "cb637548-c355-4513-8702-697f4091b494",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1059",
      "type": "users",
      "attributes": {
        "name": "Veronica Watsica",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Veronica",
        "last_name": "Watsica",
        "full_name": "Veronica Watsica",
        "full_name_with_team": "[Wintheiser, Armstrong and Hartmann] Veronica Watsica",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-03T02:05:03.948-08:00",
        "created_at": "2026-02-03T02:05:03.620-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "e6e9d44e-8c9f-4120-8821-e5e192bf653b",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "8e4324eb-b8fd-4348-8b6a-3e39b8cbd510",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ff7e2441-1037-40a3-bb46-f15cbfa52439",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "93b371e7-f439-454e-9b36-f5337279ec4c",
              "type": "user_notification_rules"
            },
            {
              "id": "accebb66-d931-4ada-8e97-ab36635ebe31",
              "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[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,
teams,
schedules,
notification_rules

Response

user found

​
data
object[]
required
​
links
object
required
​
meta
object
required