--- title: "GET journal_transactions" method: GET path: "/v3/administrations/{administration_id}/journal_transactions" tags: ["JournalTransactions"] --- # GET journal_transactions `GET /v3/administrations/{administration_id}/journal_transactions` ## Request - Base URL: `https://api.bookingexperts.com` - URL: `https://api.bookingexperts.com/v3/administrations/{administration_id}/journal_transactions` - Auth: one of: - API key in header `X-API-KEY` - OAuth 2 - Authorization code: `/oauth/authorize` - Token URL: `/oauth/token` - TypeScript: (a function with typed inputs; its response is checked against the schema) Returns journal transactions ## Path parameters - `administration_id` string, required ## Query parameters - `period` string - `page[number]` integer - `page[size]` integer - `sort` string - `fields[journal_transaction]` string - `include` string - `filter[id]` string - `filter[date]` string - `filter[created_at]` string - `filter[updated_at]` string - `filter[document_type]` string - `filter[transaction_type]` string - `filter[transaction_text]` string - `filter[debit_ledger_account]` string - `filter[credit_ledger_account]` string - `filter[debit_vat_code]` string - `filter[credit_vat_code]` string - `filter[receipt]` string - `filter[invoice]` string - `filter[payment]` string ## Headers - `Accept-Language` string ## Response `200` JournalTransactionCollectionResponse - object - `data` JournalTransaction[] - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `date` string, date - `created_at` string, date-time - `updated_at` string, date-time - `document_type` string - `transaction_type` string - `transaction_text` string - `document_name` string - `amount` string - `vat_amount` string - `relationships` object: Relationships - `debit_ledger_account` object - `data` object - `id` string: debit_ledger_account ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `credit_ledger_account` object - `data` object - `id` string: credit_ledger_account ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `debit_vat_code` object - `data` object - `id` string: debit_vat_code ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `credit_vat_code` object - `data` object - `id` string: credit_vat_code ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `receipt` object - `data` object - `id` string: receipt ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `invoice` object - `data` object - `id` string: invoice ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `payment` object - `data` object - `id` string: payment ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - `included` union[] - union - LedgerAccount - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `created_at` string, date-time - `updated_at` string, date-time - `number` string - `name` string - `report_type` string - `fixed_type` 'cash' | 'bank' | 'pin' | 'psp' | 'safe' | 'booking' | 'channel' | 'pos' | 'owner' | 'pre_invoiced_turnover' | 'vat_low_payable' | 'vat_high_payable' | 'settlements' | 'batch' | 'vouchers' | 'other_parks' | 'advances' | 'uncategorized_payments' | 'security_deposits' | 'security_deposits_damages' | 'payment_difference' | 'cash_difference' | 'rent' | 'uncategorized_expenses' | 'uncategorized_turnover': System ledger account type. Will be blank for custom made ledger accounts - `current_vat_rate` number, double - `relationships` object: Relationships - `vat_code` object - `data` object - … - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - LedgerAccount - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `created_at` string, date-time - `updated_at` string, date-time - `number` string - `name` string - `report_type` string - `fixed_type` 'cash' | 'bank' | 'pin' | 'psp' | 'safe' | 'booking' | 'channel' | 'pos' | 'owner' | 'pre_invoiced_turnover' | 'vat_low_payable' | 'vat_high_payable' | 'settlements' | 'batch' | 'vouchers' | 'other_parks' | 'advances' | 'uncategorized_payments' | 'security_deposits' | 'security_deposits_damages' | 'payment_difference' | 'cash_difference' | 'rent' | 'uncategorized_expenses' | 'uncategorized_turnover': System ledger account type. Will be blank for custom made ledger accounts - `current_vat_rate` number, double - `relationships` object: Relationships - `vat_code` object - `data` object - … - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - VATCode - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `code` string - `name` string - `relationships` object: Relationships - `vat_tariffs` object - `data` object[] - … - `current_vat_account` object: The currently applicable VAT account - `data` object - … - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - VATCode - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `code` string - `name` string - `relationships` object: Relationships - `vat_tariffs` object - `data` object[] - … - `current_vat_account` object: The currently applicable VAT account - `data` object - … - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - Receipt: A receipt is a document acknowledging that an Administration has received a Payment following a sale or other transfer of products. - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `total` object - `currency` string - `value` string - `total_without_vat` object - `currency` string - `value` string - `total_vat` object - `currency` string - `value` string - `created_at` string, date-time - `type` 'ConceptReceipt' | 'PaymentReceipt' | 'RegisterCountReceipt' | 'SalesReceipt' - `api_managed` boolean: Whether this receipt was created through an App (true) or through the BEX POS directly (false) - `settled_with` string: Documents (mostly invoices) which are settled with this receipt. This typically occurs when an invoice is paid through the point of sale. - `links` object: Links - `url` string: Link to url - `relationships` object: Relationships - `register` object - `data` object - … - `credited_receipt` object: The receipt that was credited, if any - `data` object - … - `receipt_items` object - `data` object[] - … - `payments` object - `data` object[] - … - `signatures` object - `data` object[] - … - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - Invoice: Invoices can be created for Orders, Channels and Owners. An Invoice will be in concept until it is sent, after which it becomes immutable. Changes to an Order will be invoiced by crediting the current Invoice and generating a new Invoice. - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `date` string, date: The date of the invoice - `type` 'CancellationInvoice' | 'ChannelInvoice' | 'CreditInvoice' | 'MeasurementInvoice' | 'OneOffOwnerInvoice' | 'OwnerPeriodicInvoice' | 'RentSettlementInvoice' | 'ReservationInvoice' | 'ReservationMeasurementInvoice' | 'TodoInvoice' | 'UtilitiesAdvanceInvoice' - `invoice_nr` string: The invoice number, which is unique within the administration - `sent` boolean: Returns whether this invoice has been sent - `currency` string: An ISO 4217 currency code - `reference_nr` string: Reference number from the associated booking (if any) - `company` string: The company name of the billed to party (if any) - `country_code` string: The country code of the billed to party (if any) - `city` string: The city of the billed to party (if any) - `address` string: Combined address of the billed to party (if any) - `address_line_1` string: Address line 1 of the billed to party (if any) - `address_line_2` string: Address line 2 of the billed to party (if any) - `postalcode` string: The postal code of the billed to party (if any) - `address_subdivision` string: The subdivision (state/province/region) of the billed to party (if any) - `debtor_code` string - `memo` string: Returns the current content of the memo. For booking invoices, this returns the memo of the booking. - `recurring_payment` boolean: Yields whether this invoice should be paid with recurring payment - `period_start_date` string, date: The start date of the period this invoice applies to (if any) - `period_end_date` string, date: The end date of the period this invoice applies to (if any) - `payment_deadlines` object[]: Deadlines for payment of the invoice, with the due date, open and paid amounts, and the current status. Status can have the following values: first_reminder, second_reminder, final_notice - `date` string, date - `status` string - `open_amount` object - … - `paid_amount` object - … - `total` object - `currency` string - `value` string - `total_open` object - `currency` string - `value` string - `pdf_url` string - `last_sent` string, date-time: Returns the last time this invoice was sent to the Customer. - `created_at` string, date-time - `updated_at` string, date-time - `links` object: Links - `self` string: Link to self - `url` string: Link to url - `payment_portal_short_url` string: A short URL to the payment portal for this invoice - `relationships` object: Relationships - `owner` object - `data` object - … - `invoice_items` object - `data` object[] - … - `debtor` object - `data` object - … - `links` object - … - `administration` object - `data` object - … - `links` object - … - `reservation` object: DEPRECATED use booking instead - `data` object - … - `links` object - … - `booking` object - `data` object - … - `links` object - … - `inventory_objects` object - `data` object[] - … - `credited_invoice` object: The invoice that was credited, if any - `data` object - … - `previous_invoice` object: For a mutation invoice, this yields the previous (credited) invoice - `data` object - … - `payments` object - `data` object[] - … - `security_deposits` object - `data` object[] - … - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - Payment: Represents a payment. - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `paid_at` string, date: Local payment date - `amount` object: Paid amount - `currency` string - `value` string - `payment_type` 'cash' | 'pos' | 'psp' | 'batch' | 'transfer' | 'transfered_from_invoice' | 'transfered_to_invoice' | 'credited' | 'credit' | 'voucher' | 'transfered_to_voucher' | 'imported': Payment type. On create, this must be one of: cash, pin, psp, batch, transfer - `memo` string: An optional note - `terminal_identifier` string: An optional terminal identifier for POS payments - `description` string: A short description of this payment - `created_at` string, date-time - `updated_at` string, date-time - `relationships` object: Relationships - `payment_method` object - `data` object - … - `booking` object - `data` object - … - `invoice` object - `data` object - … - `register` object: Register is required when linked with a payment_method (through payment_type) that has pos_enabled, like cash or pin payments. - `data` object - … - `administration` object - `data` object - … - `receipt` object - `data` object - … - `settled_with` object: Yields the payment on the settled invoice or receipt (if any) - `data` object - … - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - `meta` object - `pagination` object - `total_records` integer - `page` integer - `size` integer ## Other responses - `429`: Error - `default`: Error ## Changes - **2026-11-03** `ff81bc4fefa9`: 1 info - added the optional property `included/items/anyOf[#/components/schemas/Invoice]/relationships/debtor` to the response with the `200` status [Operation history](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/changes/v3/administrations/:administration_id/journal_transactions/get.md) --- [API](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3.md) - [All operations](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/revisions/ff81bc4fefa9?raw)