Search Rent Tokens

Search for rent tokens associated with a specific user and token.

Endpoint

POST /v2/users/rents/users/{user_id}/tokens/{token_id}/search

Headers

Header	Value
Content-Type	application/json
Authorization	Bearer {token}

Path Parameters

Parameter	Type	Required	Description
user_id	string	Yes	The unique identifier of the user
token_id	string	Yes	The unique identifier of the token

Request Body

{
    "page": 1,
    "per_page": 10
}

Parameters

Parameter	Type	Required	Description
page	integer	Yes	Page number for pagination
per_page	integer	Yes	Number of items per page

Response

Returns a paginated list of rent tokens associated with the user and token.

Success Response (200 OK)

{
    "data": [
        {
            "id": "string",
            "user_id": "string",
            "token_id": "string",
            "deposit_id": "string",
            "external_id": "number",
            "total_price": {
                "id": "string",
                "amount": "number",
                "decimal": "number",
                "symbol": "string",
                "address": "string"
            },
            "per_price": {
                "id": "string",
                "amount": "number",
                "decimal": "number",
                "symbol": "string",
                "address": "string"
            },
            "contract_created_at": "string",
            "created_at": "string",
            "updated_at": "string"
        }
    ],
    "total": "number",
    "page": "number",
    "per_page": "number"
}

Response Fields

Field	Type	Description
id	string	Unique identifier of the rent record
user_id	string	Unique identifier of the user
token_id	string	Unique identifier of the token
deposit_id	string	Unique identifier of the deposit
external_id	number	External identifier
total_price	object	Total price information for the rent
total_price.id	string	Currency token ID
total_price.amount	number	Total price amount
total_price.decimal	number	Number of decimal places
total_price.symbol	string	Currency symbol (e.g., "VUSD")
total_price.address	string	Contract address of the currency token
per_price	object	Price per token information
per_price.id	string	Currency token ID
per_price.amount	number	Price per token amount
per_price.decimal	number	Number of decimal places
per_price.symbol	string	Currency symbol (e.g., "VUSD")
per_price.address	string	Contract address of the currency token
contract_created_at	string | null	Timestamp when contract was created (null if not created)
created_at	string	Timestamp when the record was created
updated_at	string	Timestamp when the record was last updated

Example

Request

curl --location 'https://test-integration-api.tokenizationtr.com/v2/users/rents/users/6913872755654191dede37da/tokens/691331aec95e268b239b2d91/search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnRJRCI6Ijk3MWNlZGVmLWVlZDctNDcwZi04YWIzLTBhZTM3ZDc0NTY4NCIsImV4cGlyYXRpb24iOjE3NjMwODM3NjcsInN1cGVydmlzb3JFbWFpbCI6ImRldkBydWRpcS5jb20iLCJzdXBlcnZpc29ySUQiOiI2OGQyODBiYmM1ODA3M2NkZjU2NDJkMjAiLCJzdXBlcnZpc29yTm9kZUlEIjoiNjY1YWU1MzZhNjM5MmI3NWNmZDQwMzUyIiwic3VwZXJ2aXNvck5vZGVJbnRJRCI6MSwic3VwZXJ2aXNvck5vZGVQYXRoIjoiMSIsInN1cGVydmlzb3JSb2xlSUQiOiI2NjVhZTc5NjEwY2UyMTZkYmMzNWM5M2IiLCJzdXBlcnZpc29yUm9sZVByaW9yaXR5IjoxMDB9.0l-NJTDICHXuhwb0PGX6wwXO50zhMysxepUntC1sxJY' \
--data '{
    "page": 1,
    "per_page": 10
}'

Response

{
    "data": [
        {
            "id": "6915ced75df7fa80499a5beb",
            "user_id": "6913872755654191dede37da",
            "token_id": "691331aec95e268b239b2d91",
            "deposit_id": "6915ced75df7fa80499a5bea",
            "external_id": 1,
            "total_price": {
                "id": "6913307ec95e268b239b2d8b",
                "amount": 0.0005,
                "decimal": 6,
                "symbol": "VUSD",
                "address": "0x99f750b4a041974bfa3c072580dd4db37e2fdb18"
            },
            "per_price": {
                "id": "6913307ec95e268b239b2d8b",
                "amount": 0.0001,
                "decimal": 6,
                "symbol": "VUSD",
                "address": "0x99f750b4a041974bfa3c072580dd4db37e2fdb18"
            },
            "contract_created_at": null,
            "created_at": "2025-11-13T12:28:07.361Z",
            "updated_at": "2025-11-13T12:28:07.361Z"
        }
    ],
    "total": 1,
    "page": 1,
    "per_page": 10
}

Error Responses

400 Bad Request

{
    "error": "Invalid request parameters"
}

401 Unauthorized

{
    "error": "Authentication required"
}

403 Forbidden

{
    "error": "Access denied"
}

404 Not Found

{
    "error": "User or token not found"
}

500 Internal Server Error

{
    "error": "Internal server error"
}