List Users by ID

GET

https://api.synup.com/api/v4/users-by-ids

This API retrieves user details for one or more specified user IDs in a single request.

Behavior:

Supports fetching multiple users by providing a list of user IDs.

Returns detailed user information, including role, status, and attributes.

Request

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.synup.com/api/v4/users-by-ids?userIds' \
--header 'Authorization: API T9V35W3xxxxxxxxxxx'

Responses

🟢200OK

application/json

Successfully retrieved user details

Body

Example

{
    "data": {
        "usersByIds": [
            {
                "id": "VXNlcjoxNjUyMDY=",
                "firstName": "user",
                "lastName": "user",
                "email": "subasrisridhar879+1@gmail.com",
                "customRole": {
                    "id": "Q3VzdG9tUm9sZTo0NDUyMg==",
                    "name": "Admin"
                },
                "directCustomer": true,
                "createdAt": "2025-02-02 06:57:41 UTC",
                "inviteStatus": "RESEND_INVITE",
                "preferences": {
                    "locale": "en-US",
                    "dateFormat": null,
                    "timezone": null
                }
            }
        ]
    }
}

🟠400Bad Request

🟠401Unauthorized

Modified at 2025-07-21 09:51:44

List Users

Add Locations to User