> ## Documentation Index > Fetch the complete documentation index at: https://docs.dualentry.com/llms.txt > Use this file to discover all available pages before exploring further. # List general ledger lines > Posted general-ledger entry lines for the organization, same columns as the `general_ledger` table in your data export. Ordered by entry id. Page with the opaque `cursor` / `next_cursor` pair; do not use offset. A walk includes lines already posted when you request the first page. Postings made after that show up when you omit `cursor` and start again. ## OpenAPI ````yaml /developers/openapi/resources-v2.json get /public/v2/general_ledger/ openapi: 3.1.0 info: title: DualEntry Public API version: 2.0.0 description: '' servers: - url: https://api.dualentry.com description: Production environment security: [] tags: - name: Health description: >- Monitor API availability and service status. Use these endpoints to verify connectivity and check if the API is operational. - name: Webhooks description: >- Register webhook endpoints to receive real-time event notifications when records change in your organization. Manage subscriptions, view available topics, and inspect delivery history. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Accounts description: >- Manage your chart of accounts. Create and maintain the accounts used to categorize financial transactions, including assets, liabilities, equity, revenue, and expenses. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Reporting description: >- Reporting facts and balances: account balances as of a date; paginated general-ledger lines; dense trial-balance facts (account x company x month); chart-of-accounts facts; and consolidated rates. Row shapes match the `general_ledger`, `trial_balance`, `chart_of_accounts`, and `consolidated_rates` tables in your data export. - name: Budgets description: >- Read income statement and balance sheet budget settings. Monthly cell values, actuals comparisons, and accounts are available through separate budget routes. - name: Companies description: >- Access and manage company information. Retrieve details about your organization including legal name, tax identifiers, addresses, and accounting preferences. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Period Locks description: >- Period locks for bills, invoices, other ledger activity, non-ledger records, and tax schedules. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Payment Methods description: >- List payment methods. Filter by id to resolve payment_method_id on a payment record. V2 API only. - name: Customers description: >- Manage customer records. Create, update, and track customers who purchase goods or services from your organization, including contact information, billing addresses, and payment terms. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Contracts description: >- Manage revenue recognition contracts. Create, retrieve, and update contracts with performance obligations, manage obligation usage, and create change orders (v2). If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Items description: >- Manage products and services. Define items that appear on invoices and bills, including pricing, descriptions, and associated accounts for revenue or expense tracking. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Vendors description: >- Manage vendor and supplier records. Track businesses and individuals from whom you purchase goods or services, including contact details, payment terms, and tax information. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Journal Entries description: >- Create and manage manual journal entries. Create and update post a general ledger transaction. A reversal date posts a reversing transaction. Book ids assign accounting books. An aging reason on an accounts receivable or accounts payable line excludes that line from aging. The save can link a related journal entry and an accrual template. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Invoices description: >- Manage sales invoices. Create and track invoices sent to customers for goods or services rendered, including line items, taxes, discounts, and payment status. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Quotes description: >- Create, submit, and send CPQ quotes, with line billing frequencies, multi-year ramps, recipients and signing order, and totals by billing frequency. Requires the CPQ subscription. Save a quote with `record_status` `posted` to submit it for approval. Approvers approve or reject it in DualEntry. Send your own quote PDF. This API does not render one. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Sales Orders description: >- Create and manage sales orders. Track customer orders for goods or services before invoicing, including line items, quantities, fulfillment status, and invoicing progress. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Bills description: >- Manage vendor bills and payables. Record and track bills received from vendors for goods or services purchased, including line items, due dates, and payment tracking. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Customer Prepayments description: >- Track advance payments from customers. Access prepayments received before goods or services are delivered, which can be applied to future invoices. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Customer Prepayment Applications description: >- Apply customer prepayments and credits to invoices. Record applications of prepayments or credit memos to reduce invoice balances. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Customer Deposits description: >- Manage customer deposit transactions. Record and track deposits received from customers as security or partial payment, held in liability accounts until earned or refunded. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Customer Refunds description: >- Process and track customer refunds. Record refunds issued to customers for overpayments, returns, or cancelled transactions. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Customer Credits description: >- Manage credit memos for customers. Issue credits for returned goods, billing adjustments, or discounts that reduce customer balances or can be applied to future invoices. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Cash Sales description: >- Record immediate cash sales transactions. Track sales where payment is received at the time of sale, including point-of-sale transactions and cash receipts. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Customer Payments description: >- Record and manage customer payments. Track payments received from customers and apply them to outstanding invoices, including partial payments and overpayments. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Recurring Invoices description: >- Automate recurring billing. Set up and manage templates for invoices that are automatically generated on a regular schedule (e.g., monthly subscriptions). If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Recurring Bills description: >- Automate recurring expenses. Configure templates for bills that repeat on a regular basis (e.g., monthly rent, subscriptions) to streamline expense tracking. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Recurring Journal Entries description: >- Automate recurring journal entries. Create templates for journal entries that occur regularly (e.g., monthly depreciation, amortization) to ensure consistent accounting treatment. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Classifications description: >- Manage custom classification dimensions. Create and maintain classification categories (e.g., departments, locations, projects) used to tag and analyze transactions across multiple dimensions. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Classifications Lines description: >- Manage classification values. Define the specific values within each classification category that can be assigned to transaction line items for detailed reporting and analysis. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Custom Fields description: >- Manage custom field definitions. Extend records with organization-specific attributes: name, type (text, number, boolean, date, single_select, multi_select, currency, link, paragraph), default value, options, and which record types (invoice, bill, customer, vendor, etc.) and companies the field applies to. Values are set via the `custom_fields` attribute on each record's create/update endpoint. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Purchase Orders description: >- Create and track purchase orders. Manage formal requests to vendors for goods or services, including approval workflows, receiving tracking, and bill matching. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Vendor Payments description: >- Record vendor payments and apply them to bills, vendor credits, and journal entry lines. Create and update post a general ledger transaction. The save also computes realized, rounding, and matching gain or loss. Send attachments to replace the file list. `PATCH` changes only the sent fields. `POST /{number}/attachments/` adds files and keeps existing files. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Vendor Prepayments description: >- Track advance payments to vendors. Record prepayments made before goods or services are received, which can be applied to future bills. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Vendor Prepayment Applications description: >- Apply vendor prepayments to bills. Record applications of prepayments to reduce bill balances and track amounts owed. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Vendor Credits description: >- Manage vendor credit memos. Record credits from vendors for returned goods, billing adjustments, or discounts that reduce amounts owed or can be applied to future bills. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Vendor Refunds description: >- Process and track vendor refunds. Record refunds received from vendors for overpayments, returns, or cancelled transactions. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Paper Checks description: >- Manage paper check printing. Create, queue, and batch print paper checks for vendor payments, direct expenses, vendor prepayments, and customer refunds. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Direct Expenses description: >- Record direct expense transactions. Track payments made directly from a bank or credit card account for expenses, without going through the accounts payable process. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Bank Transfers description: >- Manage bank-to-bank transfers. Record and track transfers between bank and credit card accounts, including multi-currency transfers with exchange rate handling. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Bank Match description: >- Reconcile bank-feed rows against accounting transactions. List bank rows, trigger the matching pipeline, read AI suggestions, and confirm or undo matches. V2 API only. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Bank Connections description: >- Register and list customer-built inbound bank connection feeds. Create connections and accounts with `customer_api` as `source_type`, then push transactions separately. V2 API only. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Fixed Assets description: >- Manage fixed assets and capital equipment. Create, update, and track long-lived tangible assets including depreciation schedules, account assignments, and asset lifecycle management. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Fixed Asset Classes description: List fixed asset classes used to set `fixed_asset_class_id` on an asset. - name: Intercompany Journal Entries description: >- Create and manage intercompany journal entries. Record GL activity that spans two or more companies within the same organization, with per-line company assignment and automatic intercompany elimination. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Depreciation Books description: >- Discover available depreciation books for multi-book depreciation. Each organization has a posting book (BOOK) and may have additional tax books (FEDERAL, AMT, STATE_*). V2 API only. - name: VAT Rates description: >- Look up available VAT (Value Added Tax) rates for your organization. Use these IDs as `vat_rate_id` on transaction line items. Rates are scoped by country and include standard, reduced, zero-rated, exempt, and reverse charge types. V2 API only. - name: GST Tax Rates description: >- Look up available GST (Goods and Services Tax) rates for your organization. Use these IDs as `gst_tax_rate_id` on transaction line items. Covers AU, NZ, SG, IN, CA GST regimes and MY SST, with per-component breakdowns (e.g. CGST+SGST for India). V2 API only. - name: Product Tax Codes description: >- Manage organization product tax codes and discover global product tax codes. Use these IDs as `product_tax_code_id` on item payloads. V2 API only. - name: Approval Policies description: >- Manage approval workflows and policies. Define approval rules, steps, conditions, and approvers for different record types. Monitor workflow execution states and view approval history. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Inbox description: >- View pending approvals and approval status. Access transactions and records awaiting approval across the organization, including full approval workflow details, approvers, and action history. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: Statistical Journals description: >- Record non-monetary quantity values, such as headcount or square footage. Statistical journals never post to the general ledger. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. - name: E-invoicing description: >- Read the e-invoicing settings of the organization, the registrations of its companies, and the e-invoice filing of an invoice or a customer credit with its events and legal files. Retry a failed filing, refresh a started one, check a customer before a post, and set the e-invoicing identifiers of a customer. The settings, the registrations and the company identifiers are read-only: change them in the DualEntry app. **Subscription.** Every route except the status route needs the e-invoicing subscription. Without it, the route answers `402` before it checks the permission. The filing, its legal files and the send rules of a record that DualEntry filed still answer after the subscription ends. An organization without the subscription posts, sends and archives invoices as before. **Permissions.** The settings, the registrations and the event list need `e_invoicing:view`. The filing of a record follows the permission of its record: `invoice:view` or `customer_credit:view` to read it, `invoice:edit` or `customer_credit:edit` to retry it. The identifiers need `e_invoicing:view` with `customer:view` or `vendor:view` to read, and `e_invoicing:edit` with `customer:edit` to write, as in the app. A key that the CLI sign-in made reaches only the companies of its user. **Error codes.** A refused e-invoicing request carries a stable `error_code`: - `e_invoicing_send_held`: the authority must clear the invoice before the customer gets it. - `e_invoicing_legal_pdf_missing`: the authority PDF is not stored yet. - `e_invoicing_validation`: the authority refuses the document data. - `e_invoicing_setup`: the setup of the country is broken. - `e_invoicing_engine`: the e-invoicing engine did not answer or refused the request. - `e_invoicing_not_retryable`: the filing is not failed or rejected. - `e_invoicing_error`: any other refusal. A record save that e-invoicing refuses, such as a change of a cleared invoice, answers `422` with the reason under the `e_invoicing` key. Not in v1. - name: Data Exports description: >- Request off-cycle refreshes of your organization's data export to its configured destination (for example a Snowflake warehouse) and poll their status. Exports also run automatically on a schedule; these requests are an on-demand supplement. Requests are accepted and orchestrated by DualEntry; there is no SLA on when a run starts. If your organization connects an integration that syncs this resource with a third-party system, a change you make here can also be applied in that system, immediately or on a later sync. See the documentation for each integration for details. paths: /public/v2/general_ledger/: get: tags: - Reporting summary: List general ledger lines description: >- Posted general-ledger entry lines for the organization, same columns as the `general_ledger` table in your data export. Ordered by entry id. Page with the opaque `cursor` / `next_cursor` pair; do not use offset. A walk includes lines already posted when you request the first page. Postings made after that show up when you omit `cursor` and start again. operationId: core_api_public_general_ledger_list_general_ledger parameters: - in: query name: limit schema: default: 100 description: Number of rows to return (capped at 100) maximum: 100 minimum: 1 title: Limit type: integer required: false description: Number of rows to return (capped at 100) - in: query name: cursor schema: description: >- Opaque cursor from a previous response's next_cursor. Omit for the first page. title: Cursor type: - string - 'null' required: false description: >- Opaque cursor from a previous response's next_cursor. Omit for the first page. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PublicGeneralLedgerPageOut' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorSchema' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorSchema' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorSchema' components: schemas: PublicGeneralLedgerPageOut: properties: items: items: $ref: '#/components/schemas/PublicGeneralLedgerRowOut' title: Items type: array next_cursor: description: >- Pass as cursor on the next request. Null when there are no more rows. title: Next Cursor type: - string - 'null' required: - items title: PublicGeneralLedgerPageOut type: object ErrorSchema: properties: success: const: false default: false title: Success type: boolean errors: additionalProperties: items: type: string type: array title: Errors type: object error_code: title: Error Code type: - string - 'null' error_reason: title: Error Reason type: - string - 'null' required: - errors title: ErrorSchema type: object PublicGeneralLedgerRowOut: properties: line_id: title: Line Id type: string entry_id: title: Entry Id type: integer transaction_id: title: Transaction Id type: integer transaction_record_id: title: Transaction Record Id type: - integer - 'null' offset_entry_id: title: Offset Entry Id type: - integer - 'null' account_id: title: Account Id type: integer account_code: title: Account Code type: - string - 'null' account_number: title: Account Number type: - string - 'null' account_name: title: Account Name type: - string - 'null' account_type: title: Account Type type: - string - 'null' account_category: title: Account Category type: - string - 'null' account_hierarchy_1: title: Account Hierarchy 1 type: - string - 'null' account_hierarchy_2: title: Account Hierarchy 2 type: - string - 'null' account_hierarchy_3: title: Account Hierarchy 3 type: - string - 'null' account_hierarchy_4: title: Account Hierarchy 4 type: - string - 'null' account_hierarchy_5: title: Account Hierarchy 5 type: - string - 'null' company_id: title: Company Id type: integer company_name: title: Company Name type: - string - 'null' entity: title: Entity type: - string - 'null' company_is_elimination: title: Company Is Elimination type: - boolean - 'null' transaction_type: title: Transaction Type type: - string - 'null' doc: title: Doc type: - string - 'null' posting_date: title: Posting Date format: date type: - string - 'null' accounting_date: title: Accounting Date format: date type: - string - 'null' transaction_date: title: Transaction Date format: date type: - string - 'null' period: title: Period format: date type: - string - 'null' name: title: Name type: - string - 'null' counterparty: title: Counterparty type: - string - 'null' memo: title: Memo type: - string - 'null' line_memo: title: Line Memo type: - string - 'null' reference_number: title: Reference Number type: - string - 'null' check_number: title: Check Number type: - string - 'null' offset_account_number: title: Offset Account Number type: - string - 'null' offset_account_name: title: Offset Account Name type: - string - 'null' offset_account_is_split: title: Offset Account Is Split type: - boolean - 'null' currency_iso_4217_code: title: Currency Iso 4217 Code type: - string - 'null' base_currency: title: Base Currency type: - string - 'null' entity_currency: title: Entity Currency type: - string - 'null' transaction_currency: title: Transaction Currency type: - string - 'null' exchange_rate: title: Exchange Rate pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ type: - string - 'null' amount: title: Amount pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ type: - string - 'null' company_base_amount: title: Company Base Amount pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ type: - string - 'null' transaction_currency_amount: title: Transaction Currency Amount pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ type: - string - 'null' direction: title: Direction type: - integer - 'null' debit: title: Debit pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ type: - string - 'null' credit: title: Credit pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ type: - string - 'null' total: title: Total pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ type: - string - 'null' customer_id: title: Customer Id type: - integer - 'null' customer_name: title: Customer Name type: - string - 'null' customer_unique_id: title: Customer Unique Id type: - string - 'null' vendor_id: title: Vendor Id type: - integer - 'null' vendor_name: title: Vendor Name type: - string - 'null' line_customer_id: title: Line Customer Id type: - integer - 'null' line_customer_name: title: Line Customer Name type: - string - 'null' line_customer_unique_id: title: Line Customer Unique Id type: - string - 'null' line_vendor_id: title: Line Vendor Id type: - integer - 'null' line_vendor_name: title: Line Vendor Name type: - string - 'null' classifications: title: Classifications type: - string - 'null' custom_fields: title: Custom Fields type: - string - 'null' created_date: title: Created Date format: date type: - string - 'null' modified_date: title: Modified Date format: date type: - string - 'null' created_by: title: Created By type: - string - 'null' last_approved_by: title: Last Approved By type: - string - 'null' last_approved_date: title: Last Approved Date format: date type: - string - 'null' ship_to_address_line1: title: Ship To Address Line1 type: - string - 'null' ship_to_address_line2: title: Ship To Address Line2 type: - string - 'null' ship_to_city: title: Ship To City type: - string - 'null' ship_to_state: title: Ship To State type: - string - 'null' ship_to_zip: title: Ship To Zip type: - string - 'null' ship_to_country: title: Ship To Country type: - string - 'null' is_billable: title: Is Billable type: - boolean - 'null' billable_customer_name: title: Billable Customer Name type: - string - 'null' billable_project_name: title: Billable Project Name type: - string - 'null' billable_status: title: Billable Status type: - string - 'null' billable_invoice_number: title: Billable Invoice Number type: - string - 'null' billable_invoice_id: title: Billable Invoice Id type: - integer - 'null' billable_source_company_name: title: Billable Source Company Name type: - string - 'null' billable_ar_company_name: title: Billable Ar Company Name type: - string - 'null' intercompany_invoice_id: title: Intercompany Invoice Id type: - integer - 'null' intercompany_invoice_number: title: Intercompany Invoice Number type: - string - 'null' is_adjusting_entry: title: Is Adjusting Entry type: - boolean - 'null' is_intercompany: title: Is Intercompany type: - boolean - 'null' eliminated: title: Eliminated type: - boolean - 'null' required: - line_id - entry_id - transaction_id - account_id - company_id title: PublicGeneralLedgerRowOut type: object ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.