List specific users in bulk
curl --request POST \
--url https://databunkerpro.myorg.com/v2/BulkListUsers \
--header 'Content-Type: application/json' \
--header 'X-Bunker-Token: <api-key>' \
--data '
{
"unlockuuid": "<string>",
"users": [
{
"identity": "<string>"
}
],
"request_metadata": {}
}
'import requests
url = "https://databunkerpro.myorg.com/v2/BulkListUsers"
payload = {
"unlockuuid": "<string>",
"users": [{ "identity": "<string>" }],
"request_metadata": {}
}
headers = {
"X-Bunker-Token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Bunker-Token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({unlockuuid: '<string>', users: [{identity: '<string>'}], request_metadata: {}})
};
fetch('https://databunkerpro.myorg.com/v2/BulkListUsers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://databunkerpro.myorg.com/v2/BulkListUsers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'unlockuuid' => '<string>',
'users' => [
[
'identity' => '<string>'
]
],
'request_metadata' => [
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Bunker-Token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://databunkerpro.myorg.com/v2/BulkListUsers"
payload := strings.NewReader("{\n \"unlockuuid\": \"<string>\",\n \"users\": [\n {\n \"identity\": \"<string>\"\n }\n ],\n \"request_metadata\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Bunker-Token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://databunkerpro.myorg.com/v2/BulkListUsers")
.header("X-Bunker-Token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"unlockuuid\": \"<string>\",\n \"users\": [\n {\n \"identity\": \"<string>\"\n }\n ],\n \"request_metadata\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://databunkerpro.myorg.com/v2/BulkListUsers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Bunker-Token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"unlockuuid\": \"<string>\",\n \"users\": [\n {\n \"identity\": \"<string>\"\n }\n ],\n \"request_metadata\": {}\n}"
response = http.request(request)
puts response.read_body{
"status": "ok",
"total": 123,
"rows": [
{
"token": "<string>",
"profile": {},
"version": 123,
"finaltime": 123,
"slidingtime": 123,
"expirationtime": 123,
"grouproles": [
{}
]
}
]
}{
"status": "error",
"message": "Missing API request parameters: profile"
}{
"status": "error",
"message": "Access denied"
}{
"status": "error",
"message": "Internal error"
}Bulk Operations
List specific users in bulk
Looks up a batch of users by indexed field (email, phone, login, or custom) in a single call,
returning the token and profile for each match. Requires a unlockuuid from BulkListUnlock.
Every supplied criterion is evaluated — this endpoint is not paginated, so all matches are returned
regardless of how many criteria you send. Identities with no stored record are simply absent from
rows rather than reported as errors.
Disabled unless the list_users configuration flag is on; otherwise returns 403 BulkListUsers is disabled.
POST
/
v2
/
BulkListUsers
List specific users in bulk
curl --request POST \
--url https://databunkerpro.myorg.com/v2/BulkListUsers \
--header 'Content-Type: application/json' \
--header 'X-Bunker-Token: <api-key>' \
--data '
{
"unlockuuid": "<string>",
"users": [
{
"identity": "<string>"
}
],
"request_metadata": {}
}
'import requests
url = "https://databunkerpro.myorg.com/v2/BulkListUsers"
payload = {
"unlockuuid": "<string>",
"users": [{ "identity": "<string>" }],
"request_metadata": {}
}
headers = {
"X-Bunker-Token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Bunker-Token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({unlockuuid: '<string>', users: [{identity: '<string>'}], request_metadata: {}})
};
fetch('https://databunkerpro.myorg.com/v2/BulkListUsers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://databunkerpro.myorg.com/v2/BulkListUsers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'unlockuuid' => '<string>',
'users' => [
[
'identity' => '<string>'
]
],
'request_metadata' => [
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Bunker-Token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://databunkerpro.myorg.com/v2/BulkListUsers"
payload := strings.NewReader("{\n \"unlockuuid\": \"<string>\",\n \"users\": [\n {\n \"identity\": \"<string>\"\n }\n ],\n \"request_metadata\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Bunker-Token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://databunkerpro.myorg.com/v2/BulkListUsers")
.header("X-Bunker-Token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"unlockuuid\": \"<string>\",\n \"users\": [\n {\n \"identity\": \"<string>\"\n }\n ],\n \"request_metadata\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://databunkerpro.myorg.com/v2/BulkListUsers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Bunker-Token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"unlockuuid\": \"<string>\",\n \"users\": [\n {\n \"identity\": \"<string>\"\n }\n ],\n \"request_metadata\": {}\n}"
response = http.request(request)
puts response.read_body{
"status": "ok",
"total": 123,
"rows": [
{
"token": "<string>",
"profile": {},
"version": 123,
"finaltime": 123,
"slidingtime": 123,
"expirationtime": 123,
"grouproles": [
{}
]
}
]
}{
"status": "error",
"message": "Missing API request parameters: profile"
}{
"status": "error",
"message": "Access denied"
}{
"status": "error",
"message": "Internal error"
}Authorizations
API token for authentication
Body
application/json
⌘I