Get multiple users by user IDs
POST
/users/by/ids
using System.Net.Http.Headers;var client = new HttpClient();var request = new HttpRequestMessage{ Method = HttpMethod.Post, RequestUri = new Uri("https://api.ethos.network/api/v2/users/by/ids"), Content = new StringContent("{ \"userIds\": [ 1 ] }") { Headers = { ContentType = new MediaTypeHeaderValue("application/json") } }};using (var response = await client.SendAsync(request)){ response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body);}package main
import ( "fmt" "strings" "net/http" "io")
func main() {
url := "https://api.ethos.network/api/v2/users/by/ids"
payload := strings.NewReader("{ \"userIds\": [ 1 ] }")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close() body, _ := io.ReadAll(res.Body)
fmt.Println(res) fmt.Println(string(body))
}OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json");RequestBody body = RequestBody.create(mediaType, "{ \"userIds\": [ 1 ] }");Request request = new Request.Builder() .url("https://api.ethos.network/api/v2/users/by/ids") .post(body) .addHeader("Content-Type", "application/json") .build();
Response response = client.newCall(request).execute();import axios from 'axios';
const options = { method: 'POST', url: 'https://api.ethos.network/api/v2/users/by/ids', headers: {'Content-Type': 'application/json'}, data: {userIds: [1]}};
try { const { data } = await axios.request(options); console.log(data);} catch (error) { console.error(error);}const url = 'https://api.ethos.network/api/v2/users/by/ids';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"userIds":[1]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}use serde_json::json;use reqwest;
#[tokio::main]pub async fn main() { let url = "https://api.ethos.network/api/v2/users/by/ids";
let payload = json!({"userIds": (1)});
let mut headers = reqwest::header::HeaderMap::new(); headers.insert("Content-Type", "application/json".parse().unwrap());
let client = reqwest::Client::new(); let response = client.post(url) .headers(headers) .json(&payload) .send() .await;
let results = response.unwrap() .json::<serde_json::Value>() .await .unwrap();
dbg!(results);}curl --request POST \ --url https://api.ethos.network/api/v2/users/by/ids \ --header 'Content-Type: application/json' \ --data '{ "userIds": [ 1 ] }'wget --quiet \ --method POST \ --header 'Content-Type: application/json' \ --body-data '{ "userIds": [ 1 ] }' \ --output-document \ - https://api.ethos.network/api/v2/users/by/idsBulk lookup by Ethos user id, up to 500 per request. Unknown ids are omitted from the result rather than causing an error.
Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
userIds
required
Array<integer>
Example generated
{ "userIds": [ 1 ]}Responses
Section titled “Responses”Successful response
Media typeapplication/json
Array<object>
object
id
required
number
profileId
required
number | null
displayName
required
string
username
required
string | null
avatarUrl
required
string format: uri
description
required
string | null
score
required
number
status
required
string
userkeys
required
Array<string>
xpTotal
required
number
xpStreakDays
required
number
xpRemovedDueToAbuse
required
boolean
influenceFactor
required
number
influenceFactorPercentile
required
number
validatorNftCount
required
number
meowMeowsNftCount
required
number
links
required
object
profile
required
string format: uri
scoreBreakdown
required
string format: uri
stats
required
object
review
required
object
received
required
object
negative
required
number
neutral
required
number
positive
required
number
vouch
required
@deprecated Native-currency lifetime totals only. Use stats.vouchTotals (per-token). Removed after 2026-10-20.
object
given
required
object
amountWeiTotal
required
integer format: int64
count
required
number
received
required
object
amountWeiTotal
required
integer format: int64
count
required
number
vouchTotals
required
Array<object>
object
balance
required
object
given
required
integer format: int64
received
required
integer format: int64
count
required
object
given
required
integer
received
required
integer
Example
[ { "status": "ACTIVE", "humanVerificationStatus": "REQUESTED", "stats": { "vouchTotals": [ { "token": { "id": "eth" } } ], "whufGuarantee": { "status": "active" } } }]Invalid input data
Media typeapplication/json
Invalid input data error (400)
The error information
object
message
required
The error message
string
code
required
The error code
string
issues
An array of issues that were responsible for the error
Array<object>
object
message
required
string
Example
{ "code": "BAD_REQUEST", "message": "Invalid input data", "issues": []}Internal server error
Media typeapplication/json
Internal server error error (500)
The error information
object
message
required
The error message
string
code
required
The error code
string
issues
An array of issues that were responsible for the error
Array<object>
object
message
required
string
Example
{ "code": "INTERNAL_SERVER_ERROR", "message": "Internal server error", "issues": []}