Skip to content

Get Asset

GET
/api/v1/assets/{id}

Get a single asset by ID

id
required

Asset ID (UUID)

string format: uuid

Asset details

object
success
required
boolean
data
required
object
id
required

Asset ID

string format: uuid
Example
550e8400-e29b-41d4-a716-446655440000
userId
required

Owner user ID

string format: uuid
Example
550e8400-e29b-41d4-a716-446655440000
name
required
string
assetType
required

Type of financial asset

string
Allowed values: stock etf crypto real_estate cash bond other
Example
etf
tickerSymbol
required
string | null
isin
required
string | null
quantity
required
number
purchasePrice
required
number
currentPrice
required
number | null
currentValue
required
number | null
valueEur
required
number | null
purchaseDate
required
string | null
currency
required
string
expenseRatio
required
number | null
geographicRegion
required
string | null
sector
required
string | null
categoryId
required

Unique identifier (UUID v4)

string format: uuid
Example
550e8400-e29b-41d4-a716-446655440000
categoryName
required
string
lastUpdated
required

Timestamp in ISO 8601 format

string | null format: date-time
Example
2024-01-15T10:30:00Z
createdAt
required

Timestamp in ISO 8601 format

string format: date-time
Example
2024-01-15T10:30:00Z
updatedAt
required

Timestamp in ISO 8601 format

string format: date-time
Example
2024-01-15T10:30:00Z
meta
required
object
timestamp
required

Timestamp in ISO 8601 format

string format: date-time
Example
2024-01-15T10:30:00Z

Unauthorized

object
success
required

Always false for error responses

boolean
error
required

Error type

string
Example
Validation error
code

Machine-readable error code

string
Example
VALIDATION_ERROR
details

Detailed validation errors

Array<object>
object
path
required

Path to the invalid field

string
Example
currentAge
message
required

Error message

string
Example
Must be between 18 and 100

Asset not found

object
success
required

Always false for error responses

boolean
error
required

Error type

string
Example
Validation error
code

Machine-readable error code

string
Example
VALIDATION_ERROR
details

Detailed validation errors

Array<object>
object
path
required

Path to the invalid field

string
Example
currentAge
message
required

Error message

string
Example
Must be between 18 and 100