Trial Balance

Minimum access level: Tax, Accounting & Users, unless stated otherwise.

Get the trial balance summary

GET https://api.freeagent.com/v2/accounting/trial_balance/summary

Date Filters

GET https://api.freeagent.com/v2/accounting/trial_balance/summary?to_date=2014-05-01
GET https://api.freeagent.com/v2/accounting/trial_balance/summary?from_date=2014-01-01&to_date=2014-05-01
  • from_date - Date in YYYY-MM-DD format (optional)
  • to_date - Date in YYYY-MM-DD format

Response

If no dates are specified, the summary is for the current date.

If only to_date is specified, the summary is for a period containing the specified date. The trial balance figures are from the beginning of the accounting period up to the specified date.

If both from_date and to_date are specified, the summary is for a period with the specified custom range.

Status: 200 OK
{
  "trial_balance_summary": [
    {
      "category": "https://api.freeagent.com/v2/categories/101",
      "nominal_code": "101",
      "name": "Cost of Sales",
      "total": "275.0"
    },
    {
      "category": "https://api.freeagent.com/v2/categories/750",
      "nominal_code": "750-10",
      "name": "Bank Account Default bank account",
      "total": "-12860.0",
      "bank_account": "https://api.freeagent.com/v2/bank_accounts/10"
    },
    {
      "category": "https://api.freeagent.com/v2/categories/902",
      "nominal_code": "902-5",
      "name": "Salary and Bonuses: Bob Bobson",
      "total": "-9062.64",
      "user": "https://api.freeagent.com/v2/users/5"
    }
  ]
}
Show as XML
<?xml version="1.0" encoding="UTF-8"?>
<freeagent>
  <trial-balance-summary type="array">
    <trial-balance-summary>
      <category>https://api.freeagent.com/v2/categories/101</category>
      <nominal_code>101</nominal_code>
      <name>Cost of Sales</name>
      <total type="decimal">275.0</total>
    </trial-balance-summary>
    <trial-balance-summary>
      <category>https://api.freeagent.com/v2/categories/750</category>
      <nominal_code>750-10</nominal_code>
      <name>Bank Account Default bank account</name>
      <total type="decimal">-12860.0</total>
      <bank_account>https://api.freeagent.com/v2/bank_accounts/10</bank_account>
    </trial-balance-summary>
    <trial-balance-summary>
      <category>https://api.freeagent.com/v2/categories/902</category>
      <nominal_code>902-5</nominal_code>
      <name>Salary and Bonuses: Bob Bobson</name>
      <total type="decimal">-9062.64</total>
      <user>https://api.freeagent.com/v2/users/5</user>
    </trial-balance-summary>
</freeagent>
Show as JSON

Get the opening balances

GET https://api.freeagent.com/v2/accounting/trial_balance/summary/opening_balances

Response

Status: 200 OK
{
  "trial_balance_summary": [
    {
      "category": "https://api.freeagent.com/v2/categories/001",
      "nominal_code": "001",
      "name": "Sales",
      "total": "250.0"
    },
    {
      "category": "https://api.freeagent.com/v2/categories/750",
      "nominal_code": "750-10",
      "name": "Bank Account Default bank account",
      "total": "0.0",
      "bank_account": "https://api.freeagent.com/v2/bank_accounts/10"
    }
  ]
}
Show as XML
<?xml version="1.0" encoding="UTF-8"?>
<freeagent>
  <trial-balance-summary type="array">
    <trial-balance-summary>
      <category>https://api.freeagent.com/v2/categories/001</category>
      <nominal_code>001</nominal_code>
      <name>Sales</name>
      <total type="decimal">250.0</total>
    </trial-balance-summary>
    <trial-balance-summary>
      <category>https://api.freeagent.com/v2/categories/750</category>
      <nominal_code>750-10</nominal_code>
      <name>Bank Account Default bank account</name>
      <total type="decimal">0.0</total>
      <bank_account>https://api.freeagent.com/v2/bank_accounts/10</bank_account>
    </trial-balance-summary>
  </trial-balance-summary>
</freeagent>
Show as JSON