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": "Lindsey Torp",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Lindsey",
        "last_name": "Torp",
        "full_name": "Lindsey Torp",
        "full_name_with_team": "[Bernhard-Carroll] Lindsey Torp",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T05:41:12.345-08:00",
        "created_at": "2026-02-06T05:41:12.345-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "111f9aa8-dede-49cd-be1c-04c2bfda0f80",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "00578dd2-dd28-4666-83b8-d63076c209f6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea4a4b8c-4e1a-4f65-9c4a-8100afadb857",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "e664da11-5ba3-4f8e-ae8a-f0814fd0430f",
              "type": "user_notification_rules"
            },
            {
              "id": "3bb17bf0-64c4-47ec-827a-50a97a26f6d6",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1071",
      "type": "users",
      "attributes": {
        "name": "Joe Oberbrunner",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Joe",
        "last_name": "Oberbrunner",
        "full_name": "Joe Oberbrunner",
        "full_name_with_team": "[Bernhard-Carroll] Joe Oberbrunner",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T05:41:12.269-08:00",
        "created_at": "2026-02-06T05:41:12.269-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "4e15c1ec-ba17-4126-b02c-5b1120ce8fb1",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "9e1a6ab7-247f-4052-b416-6c59ac3c68a4",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea4a4b8c-4e1a-4f65-9c4a-8100afadb857",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "182ebfaf-c5d0-4052-92e7-565837e5769a",
              "type": "user_notification_rules"
            },
            {
              "id": "92ee5964-2c57-4ed7-a069-a79e2c136517",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1070",
      "type": "users",
      "attributes": {
        "name": "Alejandro Bernier",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Alejandro",
        "last_name": "Bernier",
        "full_name": "Alejandro Bernier",
        "full_name_with_team": "[Bernhard-Carroll] Alejandro Bernier",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T05:41:12.169-08:00",
        "created_at": "2026-02-06T05:41:12.169-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "44c3a658-215a-41d7-abf3-e7034c25e973",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d5dedb53-95d0-47a6-b581-9923070ada09",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea4a4b8c-4e1a-4f65-9c4a-8100afadb857",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "97dca80f-fdb7-4474-8eb6-1a54b1216465",
              "type": "user_notification_rules"
            },
            {
              "id": "fad1848d-750f-4857-8687-1f7a42cd0b1b",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1068",
      "type": "users",
      "attributes": {
        "name": "Deetta Quitzon",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Deetta",
        "last_name": "Quitzon",
        "full_name": "Deetta Quitzon",
        "full_name_with_team": "[Bernhard-Carroll] Deetta Quitzon",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T05:41:11.790-08:00",
        "created_at": "2026-02-06T05:41:11.790-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "e39690f2-942a-4968-afca-5bf1709870ad",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "9e1a6ab7-247f-4052-b416-6c59ac3c68a4",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea4a4b8c-4e1a-4f65-9c4a-8100afadb857",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "65cb0058-b6ce-48dc-8446-4d4ffb703d1d",
              "type": "user_notification_rules"
            },
            {
              "id": "09ef09f8-3de7-4f58-9fcb-847b87feb5ca",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1067",
      "type": "users",
      "attributes": {
        "name": "Vance Lebsack",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Vance",
        "last_name": "Lebsack",
        "full_name": "Vance Lebsack",
        "full_name_with_team": "[Bernhard-Carroll] Vance Lebsack",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T05:41:11.706-08:00",
        "created_at": "2026-02-06T05:41:11.706-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "b939736e-e8a3-45ee-9230-b6ac70b0d01a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "9e1a6ab7-247f-4052-b416-6c59ac3c68a4",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea4a4b8c-4e1a-4f65-9c4a-8100afadb857",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "c52524db-efe2-4d4e-af57-80b7cc164f64",
              "type": "user_notification_rules"
            },
            {
              "id": "7638a681-60c5-4298-9e9b-9ce007d861be",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1066",
      "type": "users",
      "attributes": {
        "name": "Dominique Davis",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Dominique",
        "last_name": "Davis",
        "full_name": "Dominique Davis",
        "full_name_with_team": "[Bernhard-Carroll] Dominique Davis",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T05:41:11.580-08:00",
        "created_at": "2026-02-06T05:41:11.580-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "085e57c8-07cd-4bcb-9acf-76fc72ecc101",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "9e1a6ab7-247f-4052-b416-6c59ac3c68a4",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea4a4b8c-4e1a-4f65-9c4a-8100afadb857",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "cfff9de5-c066-4dc1-a270-ce9539c9649b",
              "type": "user_notification_rules"
            },
            {
              "id": "90dd3627-951f-49b7-b34d-142224b2350a",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1065",
      "type": "users",
      "attributes": {
        "name": "Hugo Bashirian",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Hugo",
        "last_name": "Bashirian",
        "full_name": "Hugo Bashirian",
        "full_name_with_team": "[Bernhard-Carroll] Hugo Bashirian",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T05:41:11.495-08:00",
        "created_at": "2026-02-06T05:41:11.495-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "b06b28f9-4a6e-4cba-92c5-99caadd9dfd4",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "9e1a6ab7-247f-4052-b416-6c59ac3c68a4",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea4a4b8c-4e1a-4f65-9c4a-8100afadb857",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "6fa58b9a-4a39-45be-8b6b-43471faef094",
              "type": "user_notification_rules"
            },
            {
              "id": "8f3cbc25-2c30-47d9-86f6-4558c7d7e5d2",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1064",
      "type": "users",
      "attributes": {
        "name": "Kaley Kessler",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Kaley",
        "last_name": "Kessler",
        "full_name": "Kaley Kessler",
        "full_name_with_team": "[Bernhard-Carroll] Kaley Kessler",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T05:41:11.410-08:00",
        "created_at": "2026-02-06T05:41:11.410-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "fafe1602-74ae-4f0c-a7c4-e9ba0e0deaa5",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "9e1a6ab7-247f-4052-b416-6c59ac3c68a4",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea4a4b8c-4e1a-4f65-9c4a-8100afadb857",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "b1c9c8b5-5339-46af-a8c6-1d17a3f3c6af",
              "type": "user_notification_rules"
            },
            {
              "id": "20ff6dc4-c133-4431-a249-bcb2ddd11d44",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1063",
      "type": "users",
      "attributes": {
        "name": "Wilson Carter",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Wilson",
        "last_name": "Carter",
        "full_name": "Wilson Carter",
        "full_name_with_team": "[Bernhard-Carroll] Wilson Carter",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T05:41:11.334-08:00",
        "created_at": "2026-02-06T05:41:11.334-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "e55498fe-4ec5-4c6f-b6da-1333a7ab201e",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "9e1a6ab7-247f-4052-b416-6c59ac3c68a4",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea4a4b8c-4e1a-4f65-9c4a-8100afadb857",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "47d81b96-271b-41c7-ba1b-654800d393af",
              "type": "user_notification_rules"
            },
            {
              "id": "427fc3e1-93c8-4017-a665-dc3b8994b517",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1062",
      "type": "users",
      "attributes": {
        "name": "Shawnta Abshire",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Shawnta",
        "last_name": "Abshire",
        "full_name": "Shawnta Abshire",
        "full_name_with_team": "[Bernhard-Carroll] Shawnta Abshire",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T05:41:11.258-08:00",
        "created_at": "2026-02-06T05:41:11.258-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "f48a3bc7-8c63-431e-86a2-348c3a797075",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "9e1a6ab7-247f-4052-b416-6c59ac3c68a4",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea4a4b8c-4e1a-4f65-9c4a-8100afadb857",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "7e5ad04a-e0e5-4b35-aa3f-bc32f5f12b09",
              "type": "user_notification_rules"
            },
            {
              "id": "4599e3ed-9f02-4073-b365-3639af519001",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1061",
      "type": "users",
      "attributes": {
        "name": "Deann Wiza",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Deann",
        "last_name": "Wiza",
        "full_name": "Deann Wiza",
        "full_name_with_team": "[Bernhard-Carroll] Deann Wiza",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T05:41:11.185-08:00",
        "created_at": "2026-02-06T05:41:11.185-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "a5499be3-b258-48b8-b284-f9a893606bad",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "9e1a6ab7-247f-4052-b416-6c59ac3c68a4",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea4a4b8c-4e1a-4f65-9c4a-8100afadb857",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "564e3c9d-15c9-4eef-ad59-c75814352485",
              "type": "user_notification_rules"
            },
            {
              "id": "5fe8b8fd-0c2a-43ec-a6b7-95fb20eaa6d7",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1060",
      "type": "users",
      "attributes": {
        "name": "Matilda Jenkins",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Matilda",
        "last_name": "Jenkins",
        "full_name": "Matilda Jenkins",
        "full_name_with_team": "[Bernhard-Carroll] Matilda Jenkins",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T05:41:11.112-08:00",
        "created_at": "2026-02-06T05:41:11.112-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "abc49589-3853-4b26-bdcc-f8c04240c300",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "9e1a6ab7-247f-4052-b416-6c59ac3c68a4",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea4a4b8c-4e1a-4f65-9c4a-8100afadb857",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "e47417c6-170b-4429-828d-9466c3b48111",
              "type": "user_notification_rules"
            },
            {
              "id": "5b7c3390-7a28-4c1e-870a-cad77948b3a5",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1059",
      "type": "users",
      "attributes": {
        "name": "Dick Brown",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Dick",
        "last_name": "Brown",
        "full_name": "Dick Brown",
        "full_name_with_team": "[Bernhard-Carroll] Dick Brown",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-06T05:41:11.108-08:00",
        "created_at": "2026-02-06T05:41:10.821-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "0efba382-07bb-45f4-813f-051df2dd9e9e",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "d5dedb53-95d0-47a6-b581-9923070ada09",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "ea4a4b8c-4e1a-4f65-9c4a-8100afadb857",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "f337b5c2-c4c9-4c6e-9160-ba07ad6eaae5",
              "type": "user_notification_rules"
            },
            {
              "id": "5bc183d2-48fe-4782-8201-7d4ccb41c7ff",
              "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