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": "Anya Jacobs",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Anya",
        "last_name": "Jacobs",
        "full_name": "Anya Jacobs",
        "full_name_with_team": "[D'Amore, Ondricka and Kuhn] Anya Jacobs",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-05T01:54:29.975-08:00",
        "created_at": "2026-02-05T01:54:29.975-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "ea0725b0-a3d2-4993-9034-63c5bc44d1ed",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "c1f353e3-9ca6-4150-882d-156750787586",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "b7e50724-3ad1-496d-9ccc-ed98bcff9055",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "b4609f3a-d039-4b67-8997-671ce66cd99e",
              "type": "user_notification_rules"
            },
            {
              "id": "19f611eb-4923-4ea5-b988-16e38309cf39",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1071",
      "type": "users",
      "attributes": {
        "name": "Krissy Schultz",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Krissy",
        "last_name": "Schultz",
        "full_name": "Krissy Schultz",
        "full_name_with_team": "[D'Amore, Ondricka and Kuhn] Krissy Schultz",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-05T01:54:29.875-08:00",
        "created_at": "2026-02-05T01:54:29.875-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "11b16eeb-d5fd-49a3-b353-00277666fe71",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "123d228d-b968-471f-a18d-cde9e07b4553",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "b7e50724-3ad1-496d-9ccc-ed98bcff9055",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "1de2a8e7-7c6d-429e-9d0a-c4f9aeab7a0a",
              "type": "user_notification_rules"
            },
            {
              "id": "de3a0845-7f13-452b-9e7b-d521b3240fb7",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1070",
      "type": "users",
      "attributes": {
        "name": "Prince Streich",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Prince",
        "last_name": "Streich",
        "full_name": "Prince Streich",
        "full_name_with_team": "[D'Amore, Ondricka and Kuhn] Prince Streich",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-05T01:54:29.744-08:00",
        "created_at": "2026-02-05T01:54:29.744-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "d1f1eaed-849b-4061-9075-fcb3cc6cbe3b",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "f3872c19-236b-42d2-ba62-f43bb87379d2",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "b7e50724-3ad1-496d-9ccc-ed98bcff9055",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "b06f3d78-075f-4884-b5a8-e7bf0ad740a1",
              "type": "user_notification_rules"
            },
            {
              "id": "5eec3774-1ed3-4c98-ae8e-26b6406cd7b6",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1068",
      "type": "users",
      "attributes": {
        "name": "Martina Hane",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Martina",
        "last_name": "Hane",
        "full_name": "Martina Hane",
        "full_name_with_team": "[D'Amore, Ondricka and Kuhn] Martina Hane",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-05T01:54:29.214-08:00",
        "created_at": "2026-02-05T01:54:29.214-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "b318f233-f83b-4245-aec6-297e5ae3f638",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "123d228d-b968-471f-a18d-cde9e07b4553",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "b7e50724-3ad1-496d-9ccc-ed98bcff9055",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "ddf4e224-957d-4b5f-b249-df7a6b61416a",
              "type": "user_notification_rules"
            },
            {
              "id": "004d4a8f-03d7-4887-84b2-2b1951012abe",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1067",
      "type": "users",
      "attributes": {
        "name": "Evelyne Harvey",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Evelyne",
        "last_name": "Harvey",
        "full_name": "Evelyne Harvey",
        "full_name_with_team": "[D'Amore, Ondricka and Kuhn] Evelyne Harvey",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-05T01:54:29.125-08:00",
        "created_at": "2026-02-05T01:54:29.125-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "2d4ffb36-8755-46a2-8600-80e118bade1c",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "123d228d-b968-471f-a18d-cde9e07b4553",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "b7e50724-3ad1-496d-9ccc-ed98bcff9055",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "137044f6-7830-40a1-a0ee-cef60bc9af04",
              "type": "user_notification_rules"
            },
            {
              "id": "2aa6d45f-a961-44e4-9f1c-3b98fea9ed3a",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1066",
      "type": "users",
      "attributes": {
        "name": "Cedrick Homenick",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Cedrick",
        "last_name": "Homenick",
        "full_name": "Cedrick Homenick",
        "full_name_with_team": "[D'Amore, Ondricka and Kuhn] Cedrick Homenick",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-05T01:54:29.038-08:00",
        "created_at": "2026-02-05T01:54:29.038-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "74cf6982-f04f-4e69-9192-f17fb392831b",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "123d228d-b968-471f-a18d-cde9e07b4553",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "b7e50724-3ad1-496d-9ccc-ed98bcff9055",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "19317285-5cf4-4d1a-9bc7-088e31ba6db7",
              "type": "user_notification_rules"
            },
            {
              "id": "73b8380d-58e5-403f-89c0-c4327c2db793",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1065",
      "type": "users",
      "attributes": {
        "name": "Wilbert Anderson",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Wilbert",
        "last_name": "Anderson",
        "full_name": "Wilbert Anderson",
        "full_name_with_team": "[D'Amore, Ondricka and Kuhn] Wilbert Anderson",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-05T01:54:28.953-08:00",
        "created_at": "2026-02-05T01:54:28.953-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "80ecacf9-f7fc-4ddb-8a06-a7cc69d0a037",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "123d228d-b968-471f-a18d-cde9e07b4553",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "b7e50724-3ad1-496d-9ccc-ed98bcff9055",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "21fc0c64-b641-47af-ab85-bbc730fb6bb0",
              "type": "user_notification_rules"
            },
            {
              "id": "c5e5bdcf-d6b0-420a-a7cd-3a5f92ebfdb0",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1064",
      "type": "users",
      "attributes": {
        "name": "Cornelia Klocko",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Cornelia",
        "last_name": "Klocko",
        "full_name": "Cornelia Klocko",
        "full_name_with_team": "[D'Amore, Ondricka and Kuhn] Cornelia Klocko",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-05T01:54:28.866-08:00",
        "created_at": "2026-02-05T01:54:28.866-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "41e0736a-3865-4970-bd90-1d3fba01662b",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "123d228d-b968-471f-a18d-cde9e07b4553",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "b7e50724-3ad1-496d-9ccc-ed98bcff9055",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "6d555751-45e0-4615-85b1-8f52cad19caf",
              "type": "user_notification_rules"
            },
            {
              "id": "cc072b25-e401-475e-882a-8de6fa045ff4",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1063",
      "type": "users",
      "attributes": {
        "name": "Margrett Schmidt",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Margrett",
        "last_name": "Schmidt",
        "full_name": "Margrett Schmidt",
        "full_name_with_team": "[D'Amore, Ondricka and Kuhn] Margrett Schmidt",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-05T01:54:28.779-08:00",
        "created_at": "2026-02-05T01:54:28.779-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "a33fd980-f9d6-466c-83e0-0a3092d34e7d",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "123d228d-b968-471f-a18d-cde9e07b4553",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "b7e50724-3ad1-496d-9ccc-ed98bcff9055",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "6fb730fe-0ecd-4e6b-8b47-0668006dcbe6",
              "type": "user_notification_rules"
            },
            {
              "id": "812a4b76-1266-4ee6-b0fc-40c0d059d094",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1062",
      "type": "users",
      "attributes": {
        "name": "Ulysses Hane",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Ulysses",
        "last_name": "Hane",
        "full_name": "Ulysses Hane",
        "full_name_with_team": "[D'Amore, Ondricka and Kuhn] Ulysses Hane",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-05T01:54:28.691-08:00",
        "created_at": "2026-02-05T01:54:28.691-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "e29ad748-0834-49f4-8ec4-f5e609f05686",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "123d228d-b968-471f-a18d-cde9e07b4553",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "b7e50724-3ad1-496d-9ccc-ed98bcff9055",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "8d46d073-4a5f-448d-8627-e9401d03cebc",
              "type": "user_notification_rules"
            },
            {
              "id": "fe5adc56-7bbe-4f28-a494-35dabeb080ef",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1061",
      "type": "users",
      "attributes": {
        "name": "Pierre DuBuque",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Pierre",
        "last_name": "DuBuque",
        "full_name": "Pierre DuBuque",
        "full_name_with_team": "[D'Amore, Ondricka and Kuhn] Pierre DuBuque",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-05T01:54:28.608-08:00",
        "created_at": "2026-02-05T01:54:28.608-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "ba421cec-3544-4ea7-9331-9b4129af949b",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "123d228d-b968-471f-a18d-cde9e07b4553",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "b7e50724-3ad1-496d-9ccc-ed98bcff9055",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "a625ce9e-da10-4ad1-82a6-04b07d5e9457",
              "type": "user_notification_rules"
            },
            {
              "id": "344037d6-95eb-4642-bb55-9f953eb264b1",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1060",
      "type": "users",
      "attributes": {
        "name": "Courtney Steuber",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Courtney",
        "last_name": "Steuber",
        "full_name": "Courtney Steuber",
        "full_name_with_team": "[D'Amore, Ondricka and Kuhn] Courtney Steuber",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-05T01:54:28.524-08:00",
        "created_at": "2026-02-05T01:54:28.524-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "50fdac9f-3bec-43c7-87a0-aaa504b73695",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "123d228d-b968-471f-a18d-cde9e07b4553",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "b7e50724-3ad1-496d-9ccc-ed98bcff9055",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "7a516209-2143-48de-8d5d-4d957fe357f3",
              "type": "user_notification_rules"
            },
            {
              "id": "ad437af6-b7de-4d2f-b7a5-d3e86774d12d",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "1059",
      "type": "users",
      "attributes": {
        "name": "Aja Lowe",
        "email": "[email protected]",
        "phone": null,
        "phone_2": null,
        "first_name": "Aja",
        "last_name": "Lowe",
        "full_name": "Aja Lowe",
        "full_name_with_team": "[D'Amore, Ondricka and Kuhn] Aja Lowe",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2026-02-05T01:54:28.519-08:00",
        "created_at": "2026-02-05T01:54:28.163-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "8d5c1f5f-2879-48f7-9ccb-6fcbcc0f188b",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "f3872c19-236b-42d2-ba62-f43bb87379d2",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "b7e50724-3ad1-496d-9ccc-ed98bcff9055",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "c7f80c37-a9a7-4c82-bc24-ad014dd5dbbc",
              "type": "user_notification_rules"
            },
            {
              "id": "faf3a7a6-5e38-4e23-95ae-c879e865b61b",
              "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