curl --request GET \
--url https://api.vomo.org/v1/users \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vomo.org/v1/users', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vomo.org/v1/users"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)using RestSharp;
var options = new RestClientOptions("https://api.vomo.org/v1/users");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vomo.org/v1/users",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}HttpResponse<String> response = Unirest.get("https://api.vomo.org/v1/users")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vomo.org/v1/users")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_bodyconst url = 'https://api.vomo.org/v1/users';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"data": [
{
"type": "user",
"id": "7903",
"first_name": "Priya",
"last_name": "Sharma",
"full_name": "Priya Sharma",
"email": "priya.sharma@example.org",
"address": "123 Maple Ave, McKinney, TX 75069, USA",
"phone": "(555) 012-0103",
"birthday": "1990-03-15",
"gender": "F",
"created_at": "2025-11-01T09:00:00+00:00",
"updated_at": "2025-11-05T14:22:00+00:00",
"user_status": "VERIFIED",
"membership_status": "ACCEPTED",
"membership_role": "ORGANIZER"
},
{
"type": "user",
"id": "7821",
"first_name": "Marcus",
"last_name": "Castellano",
"full_name": "Marcus Castellano",
"email": "marcus.castellano@example.org",
"address": "456 Oak Lane, McKinney, TX 75069, USA",
"phone": "(555) 012-0101",
"birthday": "1985-07-22",
"gender": "M",
"created_at": "2025-11-02T10:00:00+00:00",
"updated_at": "2025-11-02T10:00:00+00:00",
"user_status": "VERIFIED",
"membership_status": "ACCEPTED",
"membership_role": "VOLUNTEER"
},
{
"type": "user",
"id": "8104",
"first_name": "Aisha",
"last_name": "Mohamed",
"full_name": "Aisha Mohamed",
"email": "aisha.mohamed@example.org",
"address": "789 Birch Dr, McKinney, TX 75069, USA",
"phone": "(555) 012-0104",
"birthday": "1993-11-08",
"gender": "F",
"created_at": "2025-11-03T11:00:00+00:00",
"updated_at": "2025-11-03T11:00:00+00:00",
"user_status": "VERIFIED",
"membership_status": "ACCEPTED",
"membership_role": "VOLUNTEER"
}
],
"links": {
"first": "https://api.vomo.org/v1/users?page=1",
"last": "https://api.vomo.org/v1/users?page=2",
"prev": null,
"next": "https://api.vomo.org/v1/users?page=2"
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 2,
"to": 15,
"path": "https://api.vomo.org/v1/users",
"per_page": 15,
"total": 22
}
}{
"error": {
"code": 401,
"message": "No API key provided"
}
}{
"error": {
"code": 403,
"message": "Lobby user API access is not enabled for this organization."
}
}{
"message": "The selected membership status is invalid.",
"errors": {
"membership_status": [
"The selected membership status is invalid."
]
}
}{
"message": "Too Many Attempts."
}{
"message": "Server Error"
}List / Find Users
Returns a paginated list of users in the API key organization. By default, only ACCEPTED memberships are returned. Set membership_status=LOBBY to list Lobby users when the organization has the use-api-lobby-users entitlement enabled. This entitlement is not enabled for all organizations; contact Virtuous to request access. Other membership statuses cannot be queried. Results are scoped to the API key organization, not its entire organization family.
curl --request GET \
--url https://api.vomo.org/v1/users \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vomo.org/v1/users', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vomo.org/v1/users"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)using RestSharp;
var options = new RestClientOptions("https://api.vomo.org/v1/users");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vomo.org/v1/users",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}HttpResponse<String> response = Unirest.get("https://api.vomo.org/v1/users")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vomo.org/v1/users")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_bodyconst url = 'https://api.vomo.org/v1/users';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"data": [
{
"type": "user",
"id": "7903",
"first_name": "Priya",
"last_name": "Sharma",
"full_name": "Priya Sharma",
"email": "priya.sharma@example.org",
"address": "123 Maple Ave, McKinney, TX 75069, USA",
"phone": "(555) 012-0103",
"birthday": "1990-03-15",
"gender": "F",
"created_at": "2025-11-01T09:00:00+00:00",
"updated_at": "2025-11-05T14:22:00+00:00",
"user_status": "VERIFIED",
"membership_status": "ACCEPTED",
"membership_role": "ORGANIZER"
},
{
"type": "user",
"id": "7821",
"first_name": "Marcus",
"last_name": "Castellano",
"full_name": "Marcus Castellano",
"email": "marcus.castellano@example.org",
"address": "456 Oak Lane, McKinney, TX 75069, USA",
"phone": "(555) 012-0101",
"birthday": "1985-07-22",
"gender": "M",
"created_at": "2025-11-02T10:00:00+00:00",
"updated_at": "2025-11-02T10:00:00+00:00",
"user_status": "VERIFIED",
"membership_status": "ACCEPTED",
"membership_role": "VOLUNTEER"
},
{
"type": "user",
"id": "8104",
"first_name": "Aisha",
"last_name": "Mohamed",
"full_name": "Aisha Mohamed",
"email": "aisha.mohamed@example.org",
"address": "789 Birch Dr, McKinney, TX 75069, USA",
"phone": "(555) 012-0104",
"birthday": "1993-11-08",
"gender": "F",
"created_at": "2025-11-03T11:00:00+00:00",
"updated_at": "2025-11-03T11:00:00+00:00",
"user_status": "VERIFIED",
"membership_status": "ACCEPTED",
"membership_role": "VOLUNTEER"
}
],
"links": {
"first": "https://api.vomo.org/v1/users?page=1",
"last": "https://api.vomo.org/v1/users?page=2",
"prev": null,
"next": "https://api.vomo.org/v1/users?page=2"
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 2,
"to": 15,
"path": "https://api.vomo.org/v1/users",
"per_page": 15,
"total": 22
}
}{
"error": {
"code": 401,
"message": "No API key provided"
}
}{
"error": {
"code": 403,
"message": "Lobby user API access is not enabled for this organization."
}
}{
"message": "The selected membership status is invalid.",
"errors": {
"membership_status": [
"The selected membership status is invalid."
]
}
}{
"message": "Too Many Attempts."
}{
"message": "Server Error"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Page number (if paging results).
Membership status in the API key organization. Omitted, null, or empty defaults to ACCEPTED. LOBBY requires the organization-level use-api-lobby-users entitlement; no additional API-key scope is required. Other values return 422.
ACCEPTED, LOBBY A name, or part of a name, to search for. This searches both the first and last name.
An email address, or part of an address, to search for.
Date the User account was created on or before.
Date the User account was created on or after
Date the user was updated on or before.
Date the user was updated on or after
Response
Returns the paginated list of users in the selected membership status for the API key organization. Includes pagination links and meta fields; a search with no matches returns an empty data array.
Was this page helpful?