Skip to main content

Claim Rent

Claim rent for a specific user and token.

Endpoint​

POST /v2/users/rents/{rent_id}/users/{user_id}/tokens/{token_id}/claim

Headers​

HeaderValue
Content-Typeapplication/json
AuthorizationBearer {token}

Path Parameters​

ParameterTypeRequiredDescription
rent_idintegerYesThe unique identifier of the rent
user_idstringYesThe unique identifier of the user
token_idstringYesThe unique identifier of the token

Response​

Returns a successful response with no content when the rent is successfully claimed.

Success Response (200 OK)​

No content - successful claim.

Example​

Request​

curl -X POST "{{baseUrl}}/v2/users/rents/1/users/680c02896d91ca0145cfeb81/tokens/68aeb272d9336c619ce249f6/claim" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer \{\{token\}\}" \

Response​

200 OK
(No content)

Error Responses​

400 Bad Request​

{
    "error": "Invalid request parameters"
}

401 Unauthorized​

{
    "error": "Authentication required"
}

403 Forbidden​

{
    "error": "Access denied"
}

404 Not Found​

{
    "error": "Rent, user or token not found"
}

500 Internal Server Error​

{
    "error": "Internal server error"
}