Create a new bank account balance

POST /bankaccounts/{id}/balances

Add a new balance entry for a specific bank account identified by its unique identifier. The balance entry includes the amount, timestamp, and currency code. The endpoint facilitates accurate tracking of the bank account's financial status over time.

Headers

  • Authorization string Required

    Authorization header

Path parameters

  • id string Required
application/json

Body Required

Request model for creating a new bank account balance

  • amount number

    The amount of the balance.

  • timestamp string(date-time)

    The timestamp of the balance.

  • currency object

    The currency of the balance.

    Hide currency attribute Show currency attribute object
    • code string Required

      The currency code of the balance.

Responses

  • 201 application/json

    Created

    Hide headers attributes Show headers attributes
    • Access-Control-Allow-Origin string
    • Access-Control-Allow-Credentials string
    • X-Trace-Id string
    Hide response attributes Show response attributes object

    Response model for a bank account balance

    • amount number

      The amount of the balance.

    • timestamp string(date-time)

      The timestamp of the balance.

    • currency object

      The currency of the balance.

      Hide currency attribute Show currency attribute object
      • code string Required

        The currency code of the balance.

POST /bankaccounts/{id}/balances
curl \
 --request POST 'https://rest.api.24sevenoffice.com/v1/bankaccounts/{id}/balances' \
 --header "Content-Type: application/json" \
 --header "Authorization: string" \
 --data '{"amount":1100,"timestamp":"2024-06-01T12:00:00.000Z","currency":{"code":"NOK"}}'
Request examples
# Headers
Authorization: string

# Payload
{
  "amount": 1100,
  "timestamp": "2024-06-01T12:00:00.000Z",
  "currency": {
    "code": "NOK"
  }
}
Response examples (201)
# Headers
Access-Control-Allow-Origin: string
Access-Control-Allow-Credentials: string
X-Trace-Id: string

# Payload
{
  "amount": 1100,
  "timestamp": "2024-06-01T12:00:00.000Z",
  "currency": {
    "code": "NOK"
  }
}