Skip to main content
POST
/
accounts
Create account
curl --request POST \
  --url https://api.example.com/accounts \
  --header 'Content-Type: application/json' \
  --data '
{
  "correlationId": "019bdb2a-960f-789d-8955-21720e6cdef0",
  "partyId": "019bdb2a-960f-789d-8955-21720e6cdeee",
  "currency": "EUR"
}
'
{
  "type": "https://api.ledger.finventi.com/errors/bad-request",
  "title": "Bad Request",
  "status": 400,
  "detail": "Invalid request body: correlationId is required",
  "instance": "/accounts/019bdb2a-960f-789d-8955-21720e6cdeed"
}

Body

application/json

Request to create an account for a party

correlationId
string<uuid>
required

Unique correlation identifier for tracking the request

Example:

"019bdb2a-960f-789d-8955-21720e6cdef0"

partyId
string<uuid>
required

Party ID to associate the account with

Example:

"019bdb2a-960f-789d-8955-21720e6cdeee"

currency
string
required

Account currency (only EUR supported)

Example:

"EUR"

Response

Account creation request accepted