Postings: get postings
postings_getRead-onlyIdempotent
Fetch postings for a customer account by date range. Filter by account, status, cost location, and more. Returns up to 1000 records per request.
Instructions
🟢 READ-ONLY — Fetches data. Makes no changes to the accounting records. get postings Get postings for a specified customer account. The response includes the number of returned rows and an array of postings data. NOTE: Each request is limited to 1000 postings!
Endpoint: POST /postings/get
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Set a limit of returned postings. NOTE: the maximum limit is 1000! | |
| order | No | Possible values are "default", "date ASC", "date DESC", "date_last_action ASC", "date_last_action DESC", "id_by_customer ASC", "id_by_customer DESC". The default order is ascending by date as first and date_last_action as second criterion. Please not that the validation of the specified value is case sensitive! | |
| offset | No | Set an offset for the returned postings. | |
| account | No | A comma separated list of accounts. Use the following options: all, all financial accounts, free booking and any of your available accounts as numeric value. The default is "all" | |
| api_key | No | Optional. The BB customer api_key to act on. Defaults to the BB_API_KEY configured on the server — only set this to target a different customer. | |
| date_to | Yes | The postings issuing date in format 'YYYY-MM-DD' (e.g. '2017-04-26'). All postings with issuing date including and before given value will be returned. If specified, the field will be validated. An empty string is not considered a valid date. | |
| date_from | Yes | The postings issuing date in format 'YYYY-MM-DD' (e.g. '2017-04-26'). All postings with issuing date including and after given value will be returned. If specified, the field will be validated. An empty string is not considered a valid date. | |
| cost_location | No | Set a specific cost location code. If specified, only postings to this cost location are returned | |
| posting_status | No | Set the status of the posting. You have the following options: all, fixed, unfixed The default is "all" | |
| postingaccount | No | A comma separated list of postingaccounts. Use the following options: all, all postingaccounts, all debtors, all creditors and any of your available postingaccounts as numeric value. The default is "all" | |
| date_last_action_to | No | A date in format 'YYYY-MM-DD'. All postings that were created or modified in status (confirmed, fixed) on or before this date will be returned. If specified, the field will be validated. An empty string is not considered a valid date. | |
| date_last_action_from | No | A date in format 'YYYY-MM-DD'. All postings that were created or modified in status (confirmed, fixed) on or after this date will be returned. If specified, the field will be validated. An empty string is not considered a valid date. |