> ## 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 InvoiceV2 records > Retrieve a paginated list of InvoiceV2 records with filtering and ordering options. ## OpenAPI ````yaml /developers/openapi/resources-v2.json get /public/v2/invoices/ openapi: 3.1.0 info: title: DualEntry Public API version: 2.0.0 description: '' servers: - url: https://api.dualentry.com description: Production environment - url: https://api-dev.dualentry.com description: Development environment (for testing) 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. - 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. - name: Budgets description: >- Manage financial budgets. Create and track income statement and balance sheet budgets with monthly cell values, actuals comparison, and classification filtering. - name: Companies description: >- Access and manage company information. Retrieve details about your organization including legal name, tax identifiers, addresses, and accounting preferences. - 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. - name: Contracts description: >- Manage revenue recognition contracts. Create and retrieve contracts with performance obligations, and manage obligation usage for usage-based obligations. - 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. - 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. - name: Journal Entries description: >- Create and manage manual journal entries. Record direct debits and credits to accounts for adjustments, accruals, reclassifications, and other accounting transactions. - 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. - 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. - 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. - 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. - name: Customer Prepayment Applications description: >- Apply customer prepayments and credits to invoices. Record applications of prepayments or credit memos to reduce invoice balances. - 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. - name: Customer Refunds description: >- Process and track customer refunds. Record refunds issued to customers for overpayments, returns, or cancelled transactions. - 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. - 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. - 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. - 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). - 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. - 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. - 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. - 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. - 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. - 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. - name: Vendor Payments description: >- Record and manage vendor payments. Track payments made to vendors and apply them to outstanding bills and credits, including partial payments and overpayments. - 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. - name: Vendor Prepayment Applications description: >- Apply vendor prepayments to bills. Record applications of prepayments to reduce bill balances and track amounts owed. - 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. - name: Vendor Refunds description: >- Process and track vendor refunds. Record refunds received from vendors for overpayments, returns, or cancelled transactions. - 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. - 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. - 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. - 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. - 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. - 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. - 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. - 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. paths: /public/v2/invoices/: get: tags: - Invoices summary: List InvoiceV2 records description: >- Retrieve a paginated list of InvoiceV2 records with filtering and ordering options. operationId: list_InvoiceV2_records parameters: - in: query name: integration_sources schema: title: Integration Sources items: $ref: '#/components/schemas/IntegrationSourceSlug' type: - array - 'null' required: false - in: query name: search schema: title: Search type: - string - 'null' required: false - in: query name: company_id schema: q: company_id__in title: Company Id items: type: integer type: - array - 'null' required: false - in: query name: number schema: q: number__in title: Number items: type: integer type: - array - 'null' required: false - in: query name: customer_id schema: q: customer_id__in title: Customer Id items: type: integer type: - array - 'null' required: false - in: query name: start_date schema: q: transaction__date__gte title: Start Date format: date type: - string - 'null' required: false - in: query name: end_date schema: q: transaction__date__lte title: End Date format: date type: - string - 'null' required: false - in: query name: due_date schema: q: due_date__gte title: Due Date format: date type: - string - 'null' required: false - in: query name: due_date_until schema: q: due_date__lte title: Due Date Until format: date type: - string - 'null' required: false - in: query name: transaction_currency schema: q: transaction__currency_iso_4217_code__in title: Transaction Currency items: $ref: '#/components/schemas/SystemCurrencies' type: - array - 'null' required: false - in: query name: record_status schema: q: transaction__record_status__in title: Record Status items: $ref: '#/components/schemas/RecordStatus' type: - array - 'null' required: false - in: query name: approval_status schema: title: Approval Status items: type: string type: - array - 'null' required: false - in: query name: amount_due_gte schema: anyOf: - type: number - pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ type: string - type: 'null' description: >- Return invoices whose outstanding balance (amount_due) is greater than or equal to this value. title: Amount Due Gte required: false description: >- Return invoices whose outstanding balance (amount_due) is greater than or equal to this value. - in: query name: amount_due_lte schema: anyOf: - type: number - pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ type: string - type: 'null' description: >- Return invoices whose outstanding balance (amount_due) is less than or equal to this value. title: Amount Due Lte required: false description: >- Return invoices whose outstanding balance (amount_due) is less than or equal to this value. - in: query name: amount_due_updated_at_gte schema: description: >- Return invoices whose amount_due_updated_at is greater than or equal to this timestamp. title: Amount Due Updated At Gte format: date-time type: - string - 'null' required: false description: >- Return invoices whose amount_due_updated_at is greater than or equal to this timestamp. - in: query name: amount_due_updated_at_lte schema: description: >- Return invoices whose amount_due_updated_at is less than or equal to this timestamp. title: Amount Due Updated At Lte format: date-time type: - string - 'null' required: false description: >- Return invoices whose amount_due_updated_at is less than or equal to this timestamp. - in: query name: updated_after schema: q: updated_at__gte title: Updated After format: date-time type: - string - 'null' required: false - in: query name: updated_before schema: q: updated_at__lte title: Updated Before format: date-time type: - string - 'null' required: false - in: query name: ordering schema: default: id title: Ordering type: - string - 'null' required: false - in: query name: limit schema: default: 100 description: Number of records to return per page (capped at 100) minimum: 1 title: Limit type: integer required: false description: Number of records to return per page (capped at 100) - in: query name: offset schema: default: 0 description: Number of records to skip before starting to return results minimum: 0 title: Offset type: integer required: false description: Number of records to skip before starting to return results responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PagedPublicInvoiceV2ListSchemaOut' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorSchema' components: schemas: IntegrationSourceSlug: enum: - bill_com - ramp - zoho - fivetran - stripe - hubspot - brex - cubby - avalara - deel - tax1099 - sitelink - postgresql - qlik - power_bi - snowflake - avidxchange - concur - salesforce - hmrc - quickbooks - xero - netsuite_suiteanalytics - sage_intacct - adp_totalsource - justworks - paychex_flex - paycom - gusto - ukg_ready type: string SystemCurrencies: enum: - AED - AFN - ALL - AMD - ANG - AOA - ARS - AUD - AWG - AZN - BAM - BBD - BDT - BGN - BHD - BIF - BMD - BND - BOB - BRL - BSD - BTN - BWP - BYN - BZD - CAD - CDF - CHF - CLF - CLP - CNY - COP - CRC - CUP - CVE - CZK - DJF - DKK - DOP - DZD - EGP - ERN - ETB - EUR - FJD - FKP - GBP - GEL - GHS - GIP - GMD - GNF - GTQ - GYD - HKD - HNL - HTG - HUF - IDR - ILS - INR - IQD - IRR - ISK - JMD - JOD - JPY - KES - KGS - KHR - KMF - KPW - KRW - KWD - KYD - KZT - LAK - LBP - LKR - LRD - LSL - LYD - MAD - MDL - MGA - MKD - MMK - MNT - MOP - MRU - MUR - MVR - MWK - MXN - MYR - MZN - NAD - NGN - NIO - NOK - NPR - NZD - OMR - PAB - PEN - PGK - PHP - PKR - PLN - PYG - QAR - RON - RSD - RUB - RWF - SAR - SBD - SCR - SDG - SEK - SGD - SHP - SLL - SOS - SRD - STN - SVC - SYP - SZL - THB - TJS - TMT - TND - TOP - TRY - TTD - TWD - TZS - UAH - UGX - USD - UYU - UZS - VES - VND - VUV - WST - XAF - XAG - XAU - XCD - XDR - XOF - XPD - XPF - XPT - YER - ZAR - ZMW - ZWL title: SystemCurrencies type: string RecordStatus: enum: - draft - posted - archived title: RecordStatus type: string PagedPublicInvoiceV2ListSchemaOut: properties: items: items: $ref: '#/components/schemas/PublicInvoiceV2ListSchemaOut' title: Items type: array count: title: Count type: integer required: - items - count title: PagedPublicInvoiceV2ListSchemaOut type: object ErrorSchema: properties: success: const: false default: false title: Success type: boolean errors: additionalProperties: items: type: string type: array title: Errors type: object required: - errors title: ErrorSchema type: object PublicInvoiceV2ListSchemaOut: properties: bill_to_address: deprecated: true description: >- Deprecated: send the structured billing_address / shipping_address instead. title: Bill To Address type: string ship_to_address: deprecated: true description: >- Deprecated: send the structured billing_address / shipping_address instead. title: Ship To Address type: string billing_address: anyOf: - $ref: '#/components/schemas/AddressSchemaOut' - type: 'null' shipping_address: anyOf: - $ref: '#/components/schemas/AddressSchemaOut' - type: 'null' custom_fields: default: [] items: $ref: '#/components/schemas/CustomFieldValuePairOutputSchema' title: Custom Fields type: array customer_name: title: Customer Name type: - string - 'null' attachments: default: [] items: $ref: '#/components/schemas/PublicAttachmentSchemaOut' title: Attachments type: array payment: anyOf: - $ref: '#/components/schemas/PaymentSchemaOut' - type: 'null' term_id: title: Term Id type: - integer - 'null' term_name: title: Term Name type: string transaction_ids: items: type: integer title: Transaction Ids type: array bank_match_status: title: Bank Match Status type: - string - 'null' reconciliation_status: title: Reconciliation Status type: - string - 'null' created_by: anyOf: - $ref: '#/components/schemas/AuditActorSchemaOut' - type: 'null' updated_by: anyOf: - $ref: '#/components/schemas/AuditActorSchemaOut' - type: 'null' approval_status: title: Approval Status type: - string - 'null' next_approvers: title: Next Approvers items: $ref: '#/components/schemas/ApproverDictSchema' type: - array - 'null' rejected_by: anyOf: - $ref: '#/components/schemas/RejectedBySchema' - type: 'null' internal_id: title: Internal Id type: integer number: title: Number type: integer company_id: title: Company Id type: integer company_name: title: Company Name type: string company_currency: title: Company Currency type: string customer_id: title: Customer Id type: - integer - 'null' currency_iso_4217_code: $ref: '#/components/schemas/SystemCurrencies' exchange_rate: pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,16}0*$ title: Exchange Rate type: string amount: description: Total amount of transaction pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$ title: Amount type: string amount_due: description: Amount to be paid pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$ title: Amount Due type: string paid_total: description: >- Amount that was already paid by Customer Repayment Applications or Customer Payments pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$ title: Paid Total type: string amount_due_updated_at: description: >- Timestamp of the most recent change that could have affected `amount_due`. Moves whenever the invoice itself is edited, or whenever a posted Customer Payment or Customer Prepayment Application referencing this invoice is written. format: date-time title: Amount Due Updated At type: string memo: title: Memo type: string date: description: >- Posting date (GL date) - the date when the transaction is recorded in the general ledger format: date title: Date type: string transaction_date: description: >- Transaction date (inception date) - the date when the transaction actually occurred format: date title: Transaction Date type: string due_date: title: Due Date format: date type: - string - 'null' record_status: $ref: '#/components/schemas/RecordStatus' recurring_record_number: title: Recurring Record Number type: - integer - 'null' reference_number: title: Reference Number type: string created_at: description: Date and time the record was created format: date-time title: Created At type: string updated_at: description: Date and time the record was last updated format: date-time title: Updated At type: string required: - bill_to_address - ship_to_address - term_id - term_name - transaction_ids - internal_id - number - company_id - company_name - company_currency - customer_id - currency_iso_4217_code - exchange_rate - amount - amount_due - paid_total - amount_due_updated_at - memo - date - transaction_date - due_date - record_status - recurring_record_number - reference_number - created_at - updated_at title: PublicInvoiceV2ListSchemaOut type: object AddressSchemaOut: properties: name: title: Name type: - string - 'null' street: title: Street type: string second_line: title: Second Line type: string city: title: City type: string state: title: State type: string postal_code: title: Postal Code type: string country: title: Country type: string required: - street - second_line - city - state - postal_code - country title: AddressSchemaOut type: object CustomFieldValuePairOutputSchema: properties: field: $ref: '#/components/schemas/CustomFieldSchemaOut' value: anyOf: - $ref: '#/components/schemas/CustomFieldValueSchemaOut' - type: 'null' required: - field title: CustomFieldValuePairOutputSchema type: object PublicAttachmentSchemaOut: properties: id: title: Id type: integer file_name: title: File Name type: string file_size: title: File Size type: integer download_url: title: Download Url type: - string - 'null' required: - id - file_name - file_size title: PublicAttachmentSchemaOut type: object PaymentSchemaOut: description: Schema for payment collection configuration output. properties: type: title: Type type: - string - 'null' id: title: Id type: - integer - 'null' body: title: Body type: - string - 'null' link: title: Link type: - string - 'null' title: PaymentSchemaOut type: object AuditActorSchemaOut: description: Schema for audit actor information. properties: actor_type: title: Actor Type type: - string - 'null' email: title: Email type: - string - 'null' first_name: title: First Name type: - string - 'null' last_name: title: Last Name type: - string - 'null' timestamp: title: Timestamp format: date-time type: - string - 'null' title: AuditActorSchemaOut type: object ApproverDictSchema: description: Approver info from pre-serialized dict. properties: id: title: Id type: integer first_name: title: First Name type: string last_name: title: Last Name type: string email: title: Email type: string full_name: title: Full Name type: string avatar_url: title: Avatar Url type: - string - 'null' required: - id - first_name - last_name - email - full_name title: ApproverDictSchema type: object RejectedBySchema: description: Schema for rejector information including rejection reason. properties: id: title: Id type: integer first_name: title: First Name type: string last_name: title: Last Name type: string email: title: Email type: string full_name: title: Full Name type: string rejection_reason: title: Rejection Reason type: - string - 'null' required: - id - first_name - last_name - email - full_name - rejection_reason title: RejectedBySchema type: object CustomFieldSchemaOut: properties: id: title: Id type: integer company_id: title: Company Id type: - integer - 'null' company_ids: title: Company Ids items: type: integer type: - array - 'null' name: title: Name type: string description: title: Description type: - string - 'null' helper_text: title: Helper Text type: - string - 'null' field_type: $ref: '#/components/schemas/FieldType' applies_to: items: $ref: '#/components/schemas/AppliesToItemSchema' title: Applies To type: array default_value: anyOf: - type: string - items: type: string type: array - type: 'null' title: Default Value options: title: Options items: type: string type: - array - 'null' is_active: title: Is Active type: - boolean - 'null' required: - id - name - description - helper_text - field_type - applies_to - options - is_active title: CustomFieldSchemaOut type: object CustomFieldValueSchemaOut: properties: id: title: Id type: integer custom_field_id: title: Custom Field Id type: integer custom_field_name: title: Custom Field Name type: string custom_field_type: title: Custom Field Type type: string custom_field_value_id: title: Custom Field Value Id type: integer value: title: Value created_at: title: Created At type: string updated_at: title: Updated At type: string required: - id - custom_field_id - custom_field_name - custom_field_type - custom_field_value_id - value - created_at - updated_at title: CustomFieldValueSchemaOut type: object FieldType: enum: - text - number - currency - date - boolean - single_select - multi_select - link - paragraph title: FieldType type: string AppliesToItemSchema: description: >- An entry in `applies_to` — binds a custom field to a record type with activation/required flags. properties: type: $ref: '#/components/schemas/AppliesToTypes' is_active: default: true title: Is Active type: boolean is_required: default: false title: Is Required type: boolean required: - type title: AppliesToItemSchema type: object AppliesToTypes: enum: - invoice - bill - direct_expense - journal_entry - vendor_prepayment - vendor_credit - vendor_payment - vendor_refund - customer_payment - customer_prepayment - customer_refund - customer_deposit - currency_revaluation - contract - fixed_asset - customer - vendor - company - sales_order - cash_sale - customer_credit title: AppliesToTypes type: string ````