VRPlatformVRPlatform
Accounts

/accounts/{id}/banking-init

Atomically initialize banking and return the complete opening-balance transaction and feed checkpoint. Credit cards store a negative feed balance while the journal credits the liability, unless isCreditBalance is true. Initialization can run before the team has selected its statement start date. Accounts with more than 5,000 bank records must be initialized through an operator-assisted migration. A startingBalanceDate before the team statement start date returns reason beforeStatementStartDate.

Required scope: bank-accounts:write

POST
/accounts/{id}/banking-init

Authorization

apiKey
X-API-Key<token>

API key provided in dashboard

In: header

Path Parameters

id*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Query Parameters

dryRun?boolean

Validate this request through the real write path, then roll back all changes. See https://docs.vrplatform.app/api/dry-run-mode.

Request Body

application/json

startingBalanceDate*string
startingBalanceAmount*integer

Value in cents (100 = 1€)

Range-9007199254740991 <= value <= 9007199254740991
isCreditBalance?boolean

Credit cards only. Record the amount as money the card issuer owes the business instead of money owed.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.vrplatform.app/accounts/497f6eca-6276-4993-bfeb-53cbbbba6f08/banking-init" \  -H "Content-Type: application/json" \  -d '{    "startingBalanceDate": "string",    "startingBalanceAmount": -9007199254740991  }'
{
  "id": "string",
  "archivedRecords": 0,
  "unArchivedRecords": 0,
  "transaction": {
    "description": "string",
    "status": "active",
    "uniqueRef": "string",
    "isOpeningBalance": true,
    "type": "deposit",
    "date": "string",
    "lines": [
      {
        "uniqueRef": "string",
        "description": "string",
        "assignment": "accountsPayable",
        "amount": -9007199254740991,
        "ownerStatementId": "eccddabd-554b-48ab-a66d-28a57ff66fa9",
        "matchReservationConfirmationCode": "string",
        "matchReservationStripeGuestRef": "string",
        "matchReservationProcessorBookingRef": "string",
        "matchLineTypeClassification": "string",
        "id": "string",
        "issues": [
          {
            "code": "unassignedAccount",
            "severity": "error",
            "context": {
              "lineType": "string"
            }
          }
        ],
        "recurringTemplate": {
          "id": "string"
        },
        "total": 0,
        "listing": {
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "name": "string",
          "uniqueRef": "string",
          "shortRef": "string"
        },
        "reservation": {
          "id": "string",
          "shortRef": "string",
          "confirmationCode": "string",
          "uniqueRef": "string",
          "status": "booked",
          "checkIn": "string",
          "checkOut": "string"
        },
        "account": {
          "id": "string",
          "name": "string",
          "uniqueRef": "string",
          "status": "active"
        },
        "party": "owners",
        "contact": {
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "name": "string",
          "firstName": "string",
          "uniqueRef": "string",
          "shortRef": "string",
          "email": "user@example.com",
          "type": "owner"
        },
        "matchStatus": "string",
        "appliedAmount": {
          "taxRate": {
            "id": "string",
            "name": "string",
            "basisPoints": 100000
          }
        },
        "markup": {
          "amount": -9007199254740991,
          "taxBehavior": "excluded",
          "taxRate": {
            "id": "string",
            "name": "string",
            "basisPoints": 100000
          }
        },
        "lock": {
          "status": "locked",
          "booksClosed": {
            "date": "string"
          },
          "ownerStatement": {
            "ids": [
              "497f6eca-6276-4993-bfeb-53cbbbba6f08"
            ]
          },
          "reconciled": {
            "bankRecordIds": [
              "497f6eca-6276-4993-bfeb-53cbbbba6f08"
            ]
          },
          "statementPeriod": {
            "hits": [
              {
                "listingId": "8c73d933-f7ed-437e-9da1-caac95adc1ae",
                "txnAt": "string",
                "openFrom": "string"
              }
            ]
          }
        }
      }
    ],
    "attachmentIds": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "recurringTemplateId": "d73afa31-bf14-4baf-aede-be5f4b4ff489",
    "recreatedFromTransactionId": "000264af-6c3a-4ff1-8534-ade50aa8d7fb",
    "matchBankAccountLast4": "string",
    "id": "string",
    "shortRef": "string",
    "lock": {
      "status": "locked",
      "booksClosed": {
        "date": "string"
      },
      "ownerStatement": {
        "ids": [
          "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        ]
      },
      "reconciled": {
        "bankRecordIds": [
          "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        ]
      },
      "statementPeriod": {
        "hits": [
          {
            "listingId": "8c73d933-f7ed-437e-9da1-caac95adc1ae",
            "txnAt": "string",
            "openFrom": "string"
          }
        ]
      }
    },
    "issues": [
      {
        "code": "line_unassignedAccount",
        "severity": "error",
        "context": {}
      }
    ],
    "currency": "string",
    "amount": -9007199254740991,
    "recurringTemplate": {
      "id": "string"
    },
    "attachments": [
      {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "transactionId": "75906707-8c31-479c-b354-aa805c4cefbc",
        "createdAt": "2024-01-15T12:30:00.000+00:00",
        "filename": "string",
        "extension": "string",
        "contentType": "string",
        "byteSize": -9007199254740991,
        "isOwnerAccessible": true
      }
    ],
    "account": {
      "id": "string",
      "name": "string",
      "uniqueRef": "string",
      "status": "active"
    },
    "payment": {
      "bankRecordIds": [
        "string"
      ],
      "status": "unpaid",
      "lock": {
        "status": "locked",
        "booksClosed": {
          "date": "string"
        },
        "ownerStatement": {
          "ids": [
            "497f6eca-6276-4993-bfeb-53cbbbba6f08"
          ]
        },
        "reconciled": {
          "bankRecordIds": [
            "497f6eca-6276-4993-bfeb-53cbbbba6f08"
          ]
        },
        "statementPeriod": {
          "hits": [
            {
              "listingId": "8c73d933-f7ed-437e-9da1-caac95adc1ae",
              "txnAt": "string",
              "openFrom": "string"
            }
          ]
        }
      },
      "date": "string"
    },
    "connection": {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "status": "active",
      "uniqueRef": "string",
      "appId": "string"
    },
    "contact": {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "firstName": "string",
      "uniqueRef": "string",
      "shortRef": "string",
      "email": "user@example.com",
      "type": "owner"
    },
    "source": {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "type": "string",
      "status": "active",
      "appId": "string",
      "appIcon": "string"
    },
    "createdBy": {
      "type": "user",
      "id": "string",
      "name": "string"
    },
    "matchStatus": "string",
    "matchedByBankRule": true,
    "bankRule": {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string"
    },
    "transferReconciliation": {
      "source": true,
      "destination": true
    },
    "returnedFromTransactionId": "edd2bee8-c5f7-4ff5-ae8f-fd9c96d50204",
    "returnTransactionId": "b69c7452-7c85-4196-b56f-5b3d1ed53be3",
    "returnEffectiveAt": "2024-01-15T12:30:00.000+00:00"
  },
  "bankRecord": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "uniqueRef": "string",
    "date": "string",
    "status": "active",
    "description": "string",
    "accountConnectionId": "string",
    "accountConnection": {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "connectionId": "84b500d7-71c8-4b1f-adf4-f1eb0000973d"
    },
    "accountId": "string",
    "connectionId": "84b500d7-71c8-4b1f-adf4-f1eb0000973d",
    "appId": "string",
    "type": "transaction",
    "lock": {
      "status": "locked",
      "delete": {
        "status": "locked",
        "reasons": [
          "notCsvSource"
        ]
      }
    },
    "amount": -9007199254740991,
    "balance": {
      "current": 0,
      "correction": 0
    },
    "reconciliation": {
      "status": "paid",
      "transactions": [
        {
          "id": "string",
          "date": "string",
          "description": "string",
          "type": "string",
          "amount": 0
        }
      ]
    }
  }
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "reason": "accountClassificationLocked",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "code": "duplicateLast4",
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "reason": "accountClassificationLocked",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "code": "duplicateLast4",
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "reason": "accountClassificationLocked",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "code": "duplicateLast4",
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "reason": "accountClassificationLocked",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "code": "duplicateLast4",
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "reason": "accountClassificationLocked",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "code": "duplicateLast4",
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "reason": "accountClassificationLocked",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "code": "duplicateLast4",
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "reason": "accountClassificationLocked",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "code": "duplicateLast4",
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "MISDIRECTED_REQUEST",
  "reason": "accountClassificationLocked",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "code": "duplicateLast4",
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": {
    "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec",
    "dataRegion": "ap",
    "apiBaseUrl": "http://example.com"
  }
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "reason": "accountClassificationLocked",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "code": "duplicateLast4",
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "LOCKED",
  "reason": "accountClassificationLocked",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "code": "duplicateLast4",
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "reason": "accountClassificationLocked",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "code": "duplicateLast4",
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "reason": "accountClassificationLocked",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "code": "duplicateLast4",
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}

/accounts GET

Previous Page

/accounts/{id}/connections POST

Next Page