Fetch User

Retrieve a user session information by ID

Endpoint Details

GET /users/fetch/{userId}

Path Parameters

Name	Type	Description	Required
userId	string	Existing user ID, returned upon session creation or update

Headers

Header	Value
Content-Type	application/json
Authorization	Bearer <YOUR_ACCESS_TOKEN>

Response Details

Field	Type	Description
statusCode	number	HTTP status code of the response
message	string	A brief message describing the result of the API call
metadata	metaDataObject	Contains metadata about the API call
data	userType	User object

Metadata Object

Field	Type	Description
languages	Array<string>	List of supported languages for the response, e.g. ["en"]
timestamp	string	Unix timestamp (in milliseconds) when the response was generated
timezone	string	Timezone used for the response, always "UTC"
requestId	string	Unique identifier for the API request. Used for debugging and support
path	string	API path
version	string	API version used for the request

Sample Request and Response

curl --location 'https://staging.api.liquidcommerce.cloud/users/fetch/usrid_123abc456def'
--header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>'

200

{
    "statusCode": 200,
    "message": "Get the selected user",
    "metadata": {
        "languages": [
            "en"
        ],
        "timestamp": 1731596453011,
        "timezone": "UTC",
        "requestId": "reqid_123abc45def",
        "path": "/api/users/fetch/usrid_123abc456def",
        "version": "1.7.0"
    },
    "data": {
        "id": "usr_123abc456def",
        "email": "[email protected]",
        "firstName": "John",
        "company": "",
        "lastName": "Smith",
        "phone": null,
        "profileImage": "",
        "birthDate": null,
        "createdAt": "2024-11-14T13:17:47.482Z",
        "updatedAt": "2024-11-14T14:50:54.613Z",
        "addresses": [],
        "savedPayments": []
    }
}