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": "580",
      "type": "users",
      "attributes": {
        "name": "Abdul Kirlin",
        "email": "tennille@kulas.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Abdul",
        "last_name": "Kirlin",
        "full_name": "Abdul Kirlin",
        "full_name_with_team": "[Koss, Mayer and Hodkiewicz] Abdul Kirlin",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-24T07:29:08.393-08:00",
        "created_at": "2025-11-24T07:29:08.393-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "96022cbd-653a-49a1-8381-7e7c2f2b1fca",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "f8849242-aefd-42ff-a5f8-906213b90d4e",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e6f251c-4d3f-492b-8378-2284199f6b94",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "0d922aa3-d82a-48da-8b1b-29b8465f652b",
              "type": "user_notification_rules"
            },
            {
              "id": "7a437462-82b4-4d34-949b-386cb5470df6",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "579",
      "type": "users",
      "attributes": {
        "name": "Coletta Goldner",
        "email": "lachelle@gerhold-luettgen.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Coletta",
        "last_name": "Goldner",
        "full_name": "Coletta Goldner",
        "full_name_with_team": "[Koss, Mayer and Hodkiewicz] Coletta Goldner",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-24T07:29:08.256-08:00",
        "created_at": "2025-11-24T07:29:08.256-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "7b0f2179-6698-4205-a9cd-793b8f74ce45",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0ea656aa-6b37-4d6d-8b9a-47ea76029ace",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e6f251c-4d3f-492b-8378-2284199f6b94",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "b4b6a486-e2ba-486f-8359-d234792ecd2b",
              "type": "user_notification_rules"
            },
            {
              "id": "bbd160d0-646d-4ef6-a276-1c54a32fe347",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "578",
      "type": "users",
      "attributes": {
        "name": "Maryanna Bergnaum",
        "email": "adolph_pouros@murphy.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Maryanna",
        "last_name": "Bergnaum",
        "full_name": "Maryanna Bergnaum",
        "full_name_with_team": "[Koss, Mayer and Hodkiewicz] Maryanna Bergnaum",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-24T07:29:08.056-08:00",
        "created_at": "2025-11-24T07:29:08.056-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "381425a9-2efc-423f-a018-7151db85bf5a",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "91019575-94a8-47e4-b151-e364bcec8822",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e6f251c-4d3f-492b-8378-2284199f6b94",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "f94c07fc-b5df-4294-b692-38fc19c08b8f",
              "type": "user_notification_rules"
            },
            {
              "id": "e1dcf2a6-3d4e-49ec-b626-1e5edc3d3016",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "576",
      "type": "users",
      "attributes": {
        "name": "Ismael McClure",
        "email": "talisha_macgyver@schmitt-bernhard.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Ismael",
        "last_name": "McClure",
        "full_name": "Ismael McClure",
        "full_name_with_team": "[Koss, Mayer and Hodkiewicz] Ismael McClure",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-24T07:29:07.397-08:00",
        "created_at": "2025-11-24T07:29:07.397-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "8961245c-1149-4b3c-880a-c2fe6ed49ece",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0ea656aa-6b37-4d6d-8b9a-47ea76029ace",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e6f251c-4d3f-492b-8378-2284199f6b94",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "762ae6e6-c153-4e39-9984-c74f13dfee92",
              "type": "user_notification_rules"
            },
            {
              "id": "35a13651-f3e1-4430-9ec2-9afa4a4a3498",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "575",
      "type": "users",
      "attributes": {
        "name": "Reed Romaguera",
        "email": "ora_baumbach@brekke.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Reed",
        "last_name": "Romaguera",
        "full_name": "Reed Romaguera",
        "full_name_with_team": "[Koss, Mayer and Hodkiewicz] Reed Romaguera",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-24T07:29:07.279-08:00",
        "created_at": "2025-11-24T07:29:07.279-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "16b5347b-9129-4a68-b2bc-7ff340e6ede1",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0ea656aa-6b37-4d6d-8b9a-47ea76029ace",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e6f251c-4d3f-492b-8378-2284199f6b94",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "278f18c2-acb4-4019-8f1d-4724876c21bc",
              "type": "user_notification_rules"
            },
            {
              "id": "c4d0e31f-c652-4af2-96ac-f36734d23b90",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "574",
      "type": "users",
      "attributes": {
        "name": "Zachery Carter",
        "email": "jamaal_reinger@bernier.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Zachery",
        "last_name": "Carter",
        "full_name": "Zachery Carter",
        "full_name_with_team": "[Koss, Mayer and Hodkiewicz] Zachery Carter",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-24T07:29:07.159-08:00",
        "created_at": "2025-11-24T07:29:07.159-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "66a7472c-38be-48d2-80d3-e274ed0469f2",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0ea656aa-6b37-4d6d-8b9a-47ea76029ace",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e6f251c-4d3f-492b-8378-2284199f6b94",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "1d837232-c5f7-43ed-a0e0-74f612b683e3",
              "type": "user_notification_rules"
            },
            {
              "id": "a1460787-5c70-42c8-848d-64f4c312a388",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "573",
      "type": "users",
      "attributes": {
        "name": "Seymour Krajcik",
        "email": "kasandra_trantow@gulgowski.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Seymour",
        "last_name": "Krajcik",
        "full_name": "Seymour Krajcik",
        "full_name_with_team": "[Koss, Mayer and Hodkiewicz] Seymour Krajcik",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-24T07:29:06.991-08:00",
        "created_at": "2025-11-24T07:29:06.991-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "d3b6d1b7-daa4-4a13-aded-057056bbae2b",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0ea656aa-6b37-4d6d-8b9a-47ea76029ace",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e6f251c-4d3f-492b-8378-2284199f6b94",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "854ba430-85b2-4de7-b15b-14a3022a145c",
              "type": "user_notification_rules"
            },
            {
              "id": "2ace5dae-69cf-42f7-8d79-5f78cf88f694",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "572",
      "type": "users",
      "attributes": {
        "name": "Mose Harris",
        "email": "myrta.hirthe@gerhold.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Mose",
        "last_name": "Harris",
        "full_name": "Mose Harris",
        "full_name_with_team": "[Koss, Mayer and Hodkiewicz] Mose Harris",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-24T07:29:06.870-08:00",
        "created_at": "2025-11-24T07:29:06.870-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "a6b18db5-2300-44f7-aee4-132ee58995ec",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0ea656aa-6b37-4d6d-8b9a-47ea76029ace",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e6f251c-4d3f-492b-8378-2284199f6b94",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "fac2ac65-c3c9-4014-b4f6-615f4f666bc2",
              "type": "user_notification_rules"
            },
            {
              "id": "a5094f8c-7f23-4005-8b96-b2a96ca1f651",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "571",
      "type": "users",
      "attributes": {
        "name": "Arden Crist",
        "email": "nichelle.larkin@predovic.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Arden",
        "last_name": "Crist",
        "full_name": "Arden Crist",
        "full_name_with_team": "[Koss, Mayer and Hodkiewicz] Arden Crist",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-24T07:29:06.724-08:00",
        "created_at": "2025-11-24T07:29:06.724-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "8935661e-b51a-4b83-93b9-2e35b85fe0d8",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0ea656aa-6b37-4d6d-8b9a-47ea76029ace",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e6f251c-4d3f-492b-8378-2284199f6b94",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "d24b93e9-ed70-4da9-a219-9b82c64d0d89",
              "type": "user_notification_rules"
            },
            {
              "id": "4335a735-c501-4848-aca4-dc0be1d217d1",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "570",
      "type": "users",
      "attributes": {
        "name": "Margorie Mraz",
        "email": "giovanni@kreiger.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Margorie",
        "last_name": "Mraz",
        "full_name": "Margorie Mraz",
        "full_name_with_team": "[Koss, Mayer and Hodkiewicz] Margorie Mraz",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-24T07:29:06.600-08:00",
        "created_at": "2025-11-24T07:29:06.600-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "caca2b67-7d68-41a8-8fc9-205ec2b14bcd",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0ea656aa-6b37-4d6d-8b9a-47ea76029ace",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e6f251c-4d3f-492b-8378-2284199f6b94",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "f245e39b-731d-4517-ae5d-03ecc437f3a0",
              "type": "user_notification_rules"
            },
            {
              "id": "be1a84b2-ca33-43ef-8c95-a745457e33c8",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "569",
      "type": "users",
      "attributes": {
        "name": "Steven Bernhard",
        "email": "enoch_howell@schmidt.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Steven",
        "last_name": "Bernhard",
        "full_name": "Steven Bernhard",
        "full_name_with_team": "[Koss, Mayer and Hodkiewicz] Steven Bernhard",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-24T07:29:06.456-08:00",
        "created_at": "2025-11-24T07:29:06.456-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "5735626d-c7d6-4619-8f86-068bb3f7801e",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0ea656aa-6b37-4d6d-8b9a-47ea76029ace",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e6f251c-4d3f-492b-8378-2284199f6b94",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "7fe01ee5-6bec-4525-85ab-0b1ef9cc31d8",
              "type": "user_notification_rules"
            },
            {
              "id": "c468b98b-fee7-462a-bdf6-41e133546617",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "568",
      "type": "users",
      "attributes": {
        "name": "Billy Bednar",
        "email": "fernando@flatley.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Billy",
        "last_name": "Bednar",
        "full_name": "Billy Bednar",
        "full_name_with_team": "[Koss, Mayer and Hodkiewicz] Billy Bednar",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-24T07:29:06.329-08:00",
        "created_at": "2025-11-24T07:29:06.329-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "143f0d55-0b9b-460a-a64f-79c4fe2b383b",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0ea656aa-6b37-4d6d-8b9a-47ea76029ace",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e6f251c-4d3f-492b-8378-2284199f6b94",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "fa3e09fd-668f-4a6d-bfb3-046ba574e7da",
              "type": "user_notification_rules"
            },
            {
              "id": "361a2372-20bc-4726-b059-0995fa719e9c",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "567",
      "type": "users",
      "attributes": {
        "name": "Monty Turcotte",
        "email": "tona_kerluke@little-torphy.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Monty",
        "last_name": "Turcotte",
        "full_name": "Monty Turcotte",
        "full_name_with_team": "[Koss, Mayer and Hodkiewicz] Monty Turcotte",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-24T07:29:06.323-08:00",
        "created_at": "2025-11-24T07:29:05.891-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "ed0976cb-d4b3-4e46-b1ab-d88b1a0a1f13",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "91019575-94a8-47e4-b151-e364bcec8822",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "8e6f251c-4d3f-492b-8378-2284199f6b94",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "60a24344-2725-495b-85bc-8556bc6d8fcf",
              "type": "user_notification_rules"
            },
            {
              "id": "90d3b215-5c0b-4e26-acaf-dfece6f3721b",
              "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