Create a new asset contribution

POST 
/asset-contributions

Create a new asset contribution for the authenticated user

Request

application/json

Body

required

accountIduuidrequired

ID of the account making the contribution

assetIduuidrequired

ID of the asset being contributed

assetTransferMethodIduuidrequired

ID of the transfer method to use

acquisitionOndate-timerequired

Date and time of acquisition

costBasisstringrequired
Cost basis of the contribution
Example: 1000.00
currencyTypestringrequired
Currency type for the cost basis
Example: USD
unitCountstringrequired
Number of units being contributed
Example: 1.5
unitCountExpectedstringrequired
Expected number of units to be contributed
Example: 1.5

Responses

201

Asset contribution created successfully

application/json

Schema

Schema

iduuid
accountIduuid

ID of the account making the contribution

assetIduuid

ID of the asset being contributed

assetTransferMethodIduuid

ID of the transfer method used for the contribution

acquisitionOndate-time

Date and time when the asset was acquired

costBasisstring
Cost basis of the contribution
Example: 1000.00
currencyTypestring
Type of currency used for the cost basis
Possible values: <= 50 characters
Example: USD
unitCountstring
Number of units contributed
Example: 1.5
unitCountExpectedstring
Expected number of units to be contributed
Example: 1.5
createdAtdate-time
updatedAtdate-time

Example (from schema)

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "accountId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "assetId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "assetTransferMethodId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "acquisitionOn": "2024-07-29T15:51:28.071Z",
  "costBasis": "1000.00",
  "currencyType": "USD",
  "unitCount": "1.5",
  "unitCountExpected": "1.5",
  "createdAt": "2024-07-29T15:51:28.071Z",
  "updatedAt": "2024-07-29T15:51:28.071Z"
}

400

Bad Request - Invalid input data

application/json

Schema

Schema

messagestringrequired

Error message

descriptionstring

Detailed error description

codestring

Error code

Example (from schema)

{
  "message": "Invalid input data",
  "description": "The request data did not pass validation",
  "code": "INVALID_INPUT"
}

401

Unauthorized - Invalid or missing authentication token

application/json

Schema

Schema

messagestringrequired

Error message

descriptionstring

Detailed error description

codestring

Error code

Example (from schema)

{
  "message": "Unauthorized",
  "description": "Invalid, expired or missing bearer token",
  "code": "UNAUTHORIZED"
}

403

Forbidden - Insufficient permissions

application/json

Schema

Schema

messagestringrequired

Error message

descriptionstring

Detailed error description

codestring

Error code

Example (from schema)

{
  "message": "Forbidden",
  "description": "You don't have permission to access this resource",
  "code": "FORBIDDEN"
}

404

Not Found - Resource not found

application/json

Schema

Schema

messagestringrequired

Error message

descriptionstring

Detailed error description

codestring

Error code

Example (from schema)

{
  "message": "Resource not found",
  "description": "The requested resource could not be found",
  "code": "NOT_FOUND"
}

409

Conflict - Resource already exists or state conflict

application/json

Schema

Schema

messagestringrequired

Error message

descriptionstring

Detailed error description

codestring

Error code

Example (from schema)

{
  "message": "Resource conflict",
  "description": "The resource already exists or is in an invalid state",
  "code": "CONFLICT"
}

422

Unprocessable Entity - Validation error

application/json

Schema

Schema

messagestringrequired

Error message

descriptionstring

Detailed error description

codestring

Error code

Example (from schema)

{
  "message": "Validation error",
  "description": "The request data failed validation rules",
  "code": "VALIDATION_ERROR"
}