Count journal entries

get

https://api.smoothpos.net/journals/entries/count.json

Returns how many journal entries match your filters, plus their total debits and credits. Takes the same filters as GET /journals/entries.json.

Heads up: this is a `GET` request, but it changes data. Don't call it just to look something up, and keep it away from link prefetchers and caches.

Required permission (any one of these):

Group	Permission
Finance	List and view journals
Finance	Create and reverse journals (includes view)

Query Params

account

integer

Only return entries posted to this account ID.

cost_centres

string

Comma-separated cost centre IDs; only entries in these cost centres are returned.

date_min

date-time

Only return entries dated on or after this date (ISO 8601).

date_max

date-time

Only return entries dated on or before this date (ISO 8601).

name

string

Partial match on name; Partial match on name; Partial match on name; Partial match on name.

numbers

string

Comma-separated list matched against number; Comma-separated list matched against number; Comma-separated list matched against number; Comma-separated list matched against number.

since_number

string

From (including) the number; From (including) the number; From (including) the number; From (including) the number.

before_number

string

Less than (not including) the number; Less than (not including) the number; Less than (not including) the number; Less than (not including) the number.

accounts

string

Comma-separated list matched against account_id; Comma-separated list matched against account_id.

tag

string

Tagged tags; tagged tags.

ids

string

Comma-separated list matched against id; Comma-separated list matched against id; Comma-separated list matched against id; Comma-separated list matched against id.

since_id

integer

From (including) the id; From (including) the id; From (including) the id; From (including) the id.

amount_min

date-time

From (including) the amount; From (including) the amount.

amount_max

date-time

Up to (including) the amount; Up to (including) the amount.

reversed

string

Exact match on reversed; Exact match on reversed.

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Success.

400The request couldn't be processed. Possible error messages: couldnt get tax rates account doesent exist tax rate doesent exist unbalanced journal

404Not found. Smooth POS also answers with a 404 when your token is missing or invalid, so check the error message. Possible error messages: no entries found not authorised no journals found no route journal not found