Create a bank statement

POST /api/v1/bank-statement

Personal access token & O auth2

Headers

X-PLANNR-ACCOUNT-UUID string

application/json

Body Required

statement_uuid string Required

Payment period statement UUID
date date Required

Statement date
name string

Optional title to name the bank statement. If null an auto generated name will be created.
reference string

Statement reference given by bank

Responses

201 application/json
Hide response attributes Show response attributes object
- uuid string
  
  The UUID of the resource.
- created_at string
  
  The timestamp of when the resource was created.
- updated_at string
  
  The timestamp of when the resource was updated.
- number integer
  
  Bank statement number
- reference string
  
  Bank statement reference given by bank statement
- date string
  
  Bank statement date
- name string
  
  Bank statement name
- statement object
  
  Statement
  
  Hide statement attributes Show statement attributes object
  
  uuid string
  
  created_at string
  
  updated_at string
  
  name string
  
  start_date string
  
  end_date string
  
  locked boolean
  
  locked_at string
  
  locked_by string
  
  total_expectations object
  
  Hide total_expectations attributes Show total_expectations attributes object
  
  amount string
  
  currency string
  
  formatted string
  
  total_statement_transactions object
  
  Hide total_statement_transactions attributes Show total_statement_transactions attributes object
  
  amount string
  
  currency string
  
  formatted string
  
  total_bank_transactions object
  
  Hide total_bank_transactions attributes Show total_bank_transactions attributes object
  
  amount string
  
  currency string
  
  formatted string
  
  total_expectation_amount_reconciled_to_bank object
  
  Hide total_expectation_amount_reconciled_to_bank attributes Show total_expectation_amount_reconciled_to_bank attributes object
  
  amount string
  
  currency string
  
  formatted string
  
  total_expectation_percentage_reconciled_to_bank object
  
  Hide total_expectation_percentage_reconciled_to_bank attributes Show total_expectation_percentage_reconciled_to_bank attributes object
  
  amount string
  
  currency string
  
  formatted string
  
  expectations_count integer
  
  statement_transactions_count integer
  
  statement_transactions string
- bank_transactions_count integer
  
  Total number of bank transactions within bank statement
- bank_transactions array[object]
  
  Bank transactions within bank statement
  
  Hide bank_transactions attributes Show bank_transactions attributes object
  
  uuid string
  
  created_at string
  
  updated_at string
  
  date string
  
  amount object
  
  Hide amount attributes Show amount attributes object
  
  amount string
  
  currency string
  
  formatted string
  
  reference string
  
  metadata object
  
  Hide metadata attribute Show metadata attribute object
  
  client_name string
  
  filename string
  
  bank_statement string
  
  statement string
  
  account string
  
  firm string
- total_amount object
  
  Total amount of all bank transactions within this bank statement
  
  Hide total_amount attributes Show total_amount attributes object
  
  amount string
  
  currency string
  
  formatted string
- reconciled_amount object
  
  Total amount reconciled
  
  Hide reconciled_amount attributes Show reconciled_amount attributes object
  
  amount string
  
  currency string
  
  formatted string
- reconciled_percentage number
  
  Total percentage reconciled

POST /api/v1/bank-statement

curl \
 --request POST 'https://api.plannrcrm.com/api/v1/bank-statement' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 --data '{"statement_uuid":"e41d497a-ae01-4014-a833-c4aac0be5286","date":"2025-09-17","name":"Natwest Statement #8434","reference":"BAT#8434"}'

Request examples

# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "statement_uuid": "e41d497a-ae01-4014-a833-c4aac0be5286",
  "date": "2025-09-17",
  "name": "Natwest Statement #8434",
  "reference": "BAT#8434"
}

Response examples (201)

{
  "date": "2025-09-17",
  "name": "Aviva",
  "uuid": "71ea9d11-9d19-4b50-8f1b-366664e42119",
  "number": 23,
  "reference": "SW#8434",
  "statement": {
    "name": "01/06/2022 - 30/06/2022",
    "uuid": "dfaf37c8-8c72-471d-bd23-8f95f5245e12",
    "locked": false,
    "end_date": "2022-06-01",
    "locked_at": "2025-09-17T15:46:53+01:00",
    "locked_by": "App\\Http\\Resources\\AccountResource",
    "created_at": "2025-09-17T15:46:53+01:00",
    "start_date": "2022-06-30",
    "updated_at": "2025-09-17T15:46:53+01:00",
    "expectations_count": 6,
    "total_expectations": {
      "amount": "124585",
      "currency": "GBP",
      "formatted": "£1,245.85"
    },
    "statement_transactions": "App\\Http\\Resources\\StatementTransactionResource",
    "total_bank_transactions": {
      "amount": "125599",
      "currency": "GBP",
      "formatted": "£1,255.99"
    },
    "statement_transactions_count": 6,
    "total_statement_transactions": {
      "amount": "125599",
      "currency": "GBP",
      "formatted": "£1,255.99"
    },
    "total_expectation_amount_reconciled_to_bank": {
      "amount": "125599",
      "currency": "GBP",
      "formatted": "£1,255.99"
    },
    "total_expectation_percentage_reconciled_to_bank": {
      "amount": "8570",
      "currency": "GBP",
      "formatted": "£85.70"
    }
  },
  "created_at": "2025-09-17T15:46:53+01:00",
  "updated_at": "2025-09-17T15:46:53+01:00",
  "total_amount": {
    "amount": "345895",
    "currency": "GBP",
    "formatted": "£3,458.95"
  },
  "bank_transactions": [
    {
      "date": "2022-07-15",
      "firm": "App\\Http\\Resources\\FirmResource",
      "uuid": "83df316e-fd24-4ef7-8247-a2a7be0d59e8",
      "amount": {
        "amount": "12399",
        "currency": "GBP",
        "formatted": "£123.99"
      },
      "account": "App\\Http\\Resources\\AccountResource",
      "filename": "Natwest June 2022 Statement.xlsx",
      "metadata": {
        "client_name": "Gareth Thompson"
      },
      "reference": "VitalityLtd",
      "statement": "App\\Http\\Resources\\StatementResource",
      "created_at": "2025-09-17T15:46:53+01:00",
      "updated_at": "2025-09-17T15:46:53+01:00",
      "bank_statement": "App\\Http\\Resources\\BankStatementResource"
    }
  ],
  "reconciled_amount": {
    "amount": "12849",
    "currency": "GBP",
    "formatted": "£128.49"
  },
  "reconciled_percentage": 95.68,
  "bank_transactions_count": 6
}