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": "Sheldon Jast",
        "email": "pamila@reichert.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Sheldon",
        "last_name": "Jast",
        "full_name": "Sheldon Jast",
        "full_name_with_team": "[Skiles, Marquardt and Nicolas] Sheldon Jast",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-17T05:23:59.918-08:00",
        "created_at": "2025-11-17T05:23:59.918-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "0f403396-32c1-4fe4-9967-5b8bef3fb8d7",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "0217ff61-6d01-4542-90a5-481416367777",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "eb9dcacb-4944-4c83-82eb-a306abbcbded",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "c3e58241-5f04-42b0-9e53-ba6dac2b32b0",
              "type": "user_notification_rules"
            },
            {
              "id": "f09af0f5-46a1-4ad3-8a13-4d83e0a827f0",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "579",
      "type": "users",
      "attributes": {
        "name": "Raymundo Aufderhar",
        "email": "dot@jacobson-trantow.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Raymundo",
        "last_name": "Aufderhar",
        "full_name": "Raymundo Aufderhar",
        "full_name_with_team": "[Skiles, Marquardt and Nicolas] Raymundo Aufderhar",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-17T05:23:59.698-08:00",
        "created_at": "2025-11-17T05:23:59.697-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "d1f6315c-9c3f-46f4-8f34-86100e217c56",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ed4ff0cd-ebc4-43d1-a1bc-3c396b6153a6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "eb9dcacb-4944-4c83-82eb-a306abbcbded",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "1541417e-c559-4f0c-a45b-b7eb33c1756a",
              "type": "user_notification_rules"
            },
            {
              "id": "d113a851-e979-4488-8385-e4d5a3c8572b",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "578",
      "type": "users",
      "attributes": {
        "name": "Librada Dickens",
        "email": "setsuko@walter.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Librada",
        "last_name": "Dickens",
        "full_name": "Librada Dickens",
        "full_name_with_team": "[Skiles, Marquardt and Nicolas] Librada Dickens",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-17T05:23:59.451-08:00",
        "created_at": "2025-11-17T05:23:59.451-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "6bbd7bc7-4ff1-4e49-ac25-fcf948b54b1c",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "653fee47-7f86-4bcd-8f90-6384091f86e9",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "eb9dcacb-4944-4c83-82eb-a306abbcbded",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "920b4b0b-0ea2-48ee-ab8b-4e645bc66216",
              "type": "user_notification_rules"
            },
            {
              "id": "97a30310-3dac-443c-aefe-6b6dc1697193",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "576",
      "type": "users",
      "attributes": {
        "name": "Alfonso DuBuque",
        "email": "marisha_mcclure@renner-boehm.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Alfonso",
        "last_name": "DuBuque",
        "full_name": "Alfonso DuBuque",
        "full_name_with_team": "[Skiles, Marquardt and Nicolas] Alfonso DuBuque",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-17T05:23:58.534-08:00",
        "created_at": "2025-11-17T05:23:58.534-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "072c11b2-5326-4d28-b572-2e1cf48c90a5",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ed4ff0cd-ebc4-43d1-a1bc-3c396b6153a6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "eb9dcacb-4944-4c83-82eb-a306abbcbded",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "3958fb5a-7bcd-46c1-99bf-92ae2fd5111d",
              "type": "user_notification_rules"
            },
            {
              "id": "e74b52b0-db4c-4660-959b-403846096d3f",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "575",
      "type": "users",
      "attributes": {
        "name": "Alta Abshire",
        "email": "newton@jacobi-renner.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Alta",
        "last_name": "Abshire",
        "full_name": "Alta Abshire",
        "full_name_with_team": "[Skiles, Marquardt and Nicolas] Alta Abshire",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-17T05:23:58.318-08:00",
        "created_at": "2025-11-17T05:23:58.318-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "36f88838-2ef8-44ab-b63b-a475291058dc",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ed4ff0cd-ebc4-43d1-a1bc-3c396b6153a6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "eb9dcacb-4944-4c83-82eb-a306abbcbded",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "bb4031fc-b8db-413f-92ca-9e2368912b44",
              "type": "user_notification_rules"
            },
            {
              "id": "19e297a5-8f19-4848-96d1-e62cc4f3ef51",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "574",
      "type": "users",
      "attributes": {
        "name": "France Deckow",
        "email": "dian.casper@wisozk.example",
        "phone": null,
        "phone_2": null,
        "first_name": "France",
        "last_name": "Deckow",
        "full_name": "France Deckow",
        "full_name_with_team": "[Skiles, Marquardt and Nicolas] France Deckow",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-17T05:23:58.147-08:00",
        "created_at": "2025-11-17T05:23:58.147-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "99235e36-e13c-4d28-a092-c1ccd40d1d73",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ed4ff0cd-ebc4-43d1-a1bc-3c396b6153a6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "eb9dcacb-4944-4c83-82eb-a306abbcbded",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "0a7e7b2d-c2f8-4415-bcea-feb3f79cd5d1",
              "type": "user_notification_rules"
            },
            {
              "id": "00d95b70-41f4-426e-9507-efe2157d699d",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "573",
      "type": "users",
      "attributes": {
        "name": "Patrina Kunze",
        "email": "darlena@batz.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Patrina",
        "last_name": "Kunze",
        "full_name": "Patrina Kunze",
        "full_name_with_team": "[Skiles, Marquardt and Nicolas] Patrina Kunze",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-17T05:23:58.035-08:00",
        "created_at": "2025-11-17T05:23:58.035-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "7c56792c-3ec9-438f-814b-ccb799a53bbc",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ed4ff0cd-ebc4-43d1-a1bc-3c396b6153a6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "eb9dcacb-4944-4c83-82eb-a306abbcbded",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "19aeefcd-6c45-437c-b873-f909a8757f97",
              "type": "user_notification_rules"
            },
            {
              "id": "dc27f8b2-4130-4010-932a-c61544342165",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "572",
      "type": "users",
      "attributes": {
        "name": "Benton O'Kon",
        "email": "leo_schroeder@feeney.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Benton",
        "last_name": "O'Kon",
        "full_name": "Benton O'Kon",
        "full_name_with_team": "[Skiles, Marquardt and Nicolas] Benton O'Kon",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-17T05:23:57.924-08:00",
        "created_at": "2025-11-17T05:23:57.924-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "898b164f-bc27-4b22-9202-5be92eadc42f",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ed4ff0cd-ebc4-43d1-a1bc-3c396b6153a6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "eb9dcacb-4944-4c83-82eb-a306abbcbded",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "ba3dd5d6-36fc-45e1-bfea-d29c33af0968",
              "type": "user_notification_rules"
            },
            {
              "id": "eee5fd87-9233-4595-8a06-01ec8383b0b8",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "571",
      "type": "users",
      "attributes": {
        "name": "Richie Waelchi",
        "email": "ty@marks-harvey.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Richie",
        "last_name": "Waelchi",
        "full_name": "Richie Waelchi",
        "full_name_with_team": "[Skiles, Marquardt and Nicolas] Richie Waelchi",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-17T05:23:57.807-08:00",
        "created_at": "2025-11-17T05:23:57.807-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "8a6318fd-9805-4374-bb89-5d40fe9c787c",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ed4ff0cd-ebc4-43d1-a1bc-3c396b6153a6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "eb9dcacb-4944-4c83-82eb-a306abbcbded",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "c7d23314-cfd1-44f2-873d-839b06295fac",
              "type": "user_notification_rules"
            },
            {
              "id": "be4a8bdf-c351-4378-964d-fbc4319fbcaa",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "570",
      "type": "users",
      "attributes": {
        "name": "Catherin Stanton",
        "email": "guy@littel.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Catherin",
        "last_name": "Stanton",
        "full_name": "Catherin Stanton",
        "full_name_with_team": "[Skiles, Marquardt and Nicolas] Catherin Stanton",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-17T05:23:57.663-08:00",
        "created_at": "2025-11-17T05:23:57.663-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "f3f3f402-a34e-4968-922e-c2466ac32336",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ed4ff0cd-ebc4-43d1-a1bc-3c396b6153a6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "eb9dcacb-4944-4c83-82eb-a306abbcbded",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "4991ecd9-ab57-4fee-8a20-1e942be7e0d6",
              "type": "user_notification_rules"
            },
            {
              "id": "529b47aa-c2d3-461f-aa8b-931d48dd9dee",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "569",
      "type": "users",
      "attributes": {
        "name": "Pandora Langosh",
        "email": "roderick@oconnell.test",
        "phone": null,
        "phone_2": null,
        "first_name": "Pandora",
        "last_name": "Langosh",
        "full_name": "Pandora Langosh",
        "full_name_with_team": "[Skiles, Marquardt and Nicolas] Pandora Langosh",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-17T05:23:57.550-08:00",
        "created_at": "2025-11-17T05:23:57.550-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "88987adb-c3b2-470a-a5e5-5843a5d36f8e",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ed4ff0cd-ebc4-43d1-a1bc-3c396b6153a6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "eb9dcacb-4944-4c83-82eb-a306abbcbded",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "68914010-a45c-44ff-9d8d-a9b5340efd40",
              "type": "user_notification_rules"
            },
            {
              "id": "037af7ff-5b77-44b3-b761-de48c8b2b26d",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "568",
      "type": "users",
      "attributes": {
        "name": "Cinthia Heathcote",
        "email": "dimple.champlin@aufderhar.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Cinthia",
        "last_name": "Heathcote",
        "full_name": "Cinthia Heathcote",
        "full_name_with_team": "[Skiles, Marquardt and Nicolas] Cinthia Heathcote",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-17T05:23:57.425-08:00",
        "created_at": "2025-11-17T05:23:57.425-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "baa5bc9b-dba8-4831-a4b6-20558eca6154",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "ed4ff0cd-ebc4-43d1-a1bc-3c396b6153a6",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "eb9dcacb-4944-4c83-82eb-a306abbcbded",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "dc620aa9-65c1-4ba3-b5a7-14af14818e5e",
              "type": "user_notification_rules"
            },
            {
              "id": "a156c63f-9677-4b21-874a-25199d9fb341",
              "type": "user_notification_rules"
            }
          ]
        }
      }
    },
    {
      "id": "567",
      "type": "users",
      "attributes": {
        "name": "Verdie Larkin",
        "email": "laurie@reichert.example",
        "phone": null,
        "phone_2": null,
        "first_name": "Verdie",
        "last_name": "Larkin",
        "full_name": "Verdie Larkin",
        "full_name_with_team": "[Skiles, Marquardt and Nicolas] Verdie Larkin",
        "slack_id": null,
        "time_zone": "Etc/UTC",
        "updated_at": "2025-11-17T05:23:57.419-08:00",
        "created_at": "2025-11-17T05:23:56.896-08:00"
      },
      "relationships": {
        "email_addresses": {
          "data": [
            {
              "id": "1d4203f6-ffbf-422a-ab0d-8c456ca7c4c0",
              "type": "user_email_addresses"
            }
          ]
        },
        "phone_numbers": {
          "data": []
        },
        "devices": {
          "data": []
        },
        "role": {
          "data": {
            "id": "653fee47-7f86-4bcd-8f90-6384091f86e9",
            "type": "roles"
          }
        },
        "on_call_role": {
          "data": {
            "id": "eb9dcacb-4944-4c83-82eb-a306abbcbded",
            "type": "on_call_roles"
          }
        },
        "teams": {
          "data": []
        },
        "schedules": {
          "data": []
        },
        "notification_rules": {
          "data": [
            {
              "id": "9ca8fefa-5036-4fc4-8753-4434b2924e15",
              "type": "user_notification_rules"
            },
            {
              "id": "24165b0f-02e1-4aa7-b7f6-39490e453ac3",
              "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