> ## Documentation Index
> Fetch the complete documentation index at: https://docs.incard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List outbound invoices

> Lists outbound invoices for the authenticated company. Requires permission `request_payments`.



## OpenAPI

````yaml /specs/company.openapi.yaml get /developer/company/invoices
openapi: 3.1.0
info:
  title: Incard Developer API
  version: 0.1.0
  description: OpenAPI definition for the Incard Developer API.
servers:
  - url: https://api.incard.com
    description: Developer Gateway (production)
  - url: https://api-nonprod.incard.com
    description: Developer Gateway (non-production)
security:
  - BearerAuth: []
tags:
  - name: INVOICES
  - name: webhooks
paths:
  /developer/company/invoices:
    get:
      tags:
        - INVOICES
      summary: List outbound invoices
      description: >-
        Lists outbound invoices for the authenticated company. Requires
        permission `request_payments`.
      operationId: list_outbound_invoices
      responses:
        '200':
          description: Paginated outbound invoice collection.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    description: Outbound invoices for the current page.
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          description: Outbound invoice UUID.
                          type: string
                        public_id:
                          description: Public invoice identifier.
                          type: string
                        status:
                          description: Invoice lifecycle status.
                          type: string
                        due_date:
                          description: Invoice due date.
                          format: date-time
                          type: string
                        issued_at:
                          description: Invoice issue date.
                          format: date-time
                          type: string
                        cancelled_at:
                          description: (Optional) Invoice cancellation timestamp.
                          format: date-time
                          type:
                            - string
                            - 'null'
                        invoice_number:
                          description: (Optional) Merchant-facing invoice number.
                          type:
                            - string
                            - 'null'
                        reference:
                          description: (Optional) Invoice reference.
                          type:
                            - string
                            - 'null'
                        deposit_account_id:
                          description: Deposit account UUID.
                          type: string
                        amount:
                          description: Invoice amount.
                          type: number
                        line_items:
                          description: Invoice line items.
                          type: array
                          items:
                            type: object
                            properties:
                              quantity:
                                description: Line item quantity.
                                type: number
                              unit_price:
                                description: Line item unit price.
                                type: number
                              discount:
                                description: Line item discount percentage.
                                type: number
                              description:
                                description: Line item description.
                                type: string
                            required:
                              - quantity
                              - unit_price
                              - discount
                              - description
                        template_id:
                          description: Invoice template UUID.
                          type: string
                        recipient_id:
                          description: Recipient contact UUID.
                          type: string
                        currency:
                          description: Invoice currency code.
                          type: string
                        notes:
                          description: (Optional) Invoice notes.
                          type:
                            - string
                            - 'null'
                        requested_by:
                          description: (Optional) Requester user details.
                          type:
                            - object
                            - 'null'
                        transaction_id:
                          description: (Optional) Linked transaction UUID.
                          type:
                            - string
                            - 'null'
                        template:
                          description: (Optional) Invoice template details.
                          type:
                            - object
                            - 'null'
                        recipient:
                          description: (Optional) Recipient contact details.
                          type:
                            - object
                            - 'null'
                        reminderSchedule:
                          description: (Optional) Active reminder schedule for the invoice.
                          type:
                            - object
                            - 'null'
                      required:
                        - id
                        - public_id
                        - status
                        - due_date
                        - issued_at
                        - deposit_account_id
                        - amount
                        - line_items
                        - template_id
                        - recipient_id
                        - currency
                  meta:
                    type: object
                    properties:
                      total:
                        description: Total number of matching outbound invoices.
                        type: number
                      take:
                        description: Maximum number of invoices returned.
                        type: number
                      skip:
                        description: Number of invoices skipped before this page.
                        type: number
                    required:
                      - total
                      - take
                      - skip
                required:
                  - data
                title: OutboundInvoiceCollection
              example:
                data:
                  - id: 11111111-1111-4111-8111-000000000206
                    public_id: invoice_api_doc_list_001
                    status: pending
                    due_date: '2027-02-01T00:00:00.000Z'
                    issued_at: '2027-01-01T00:00:00.000Z'
                    cancelled_at: null
                    invoice_number: INV-API-DOC-001
                    reference: API documentation example
                    deposit_account_id: 11111111-1111-4111-8111-000000000203
                    amount: 100
                    line_items:
                      - quantity: 1
                        unit_price: 100
                        discount: 0
                        description: Integration test line item
                    template_id: 11111111-1111-4111-8111-000000000205
                    recipient_id: 11111111-1111-4111-8111-000000000204
                    currency: GBP
                    notes: Created for API documentation examples.
                    requested_by:
                      id: 11111111-1111-4111-8111-000000000202
                      first_name: Integration
                      last_name: Tester
                      email: integration-tester@incard.test
                    transaction_id: null
                    template:
                      id: 11111111-1111-4111-8111-000000000205
                      name: Template api-doc-list
                      background_type: colour
                      background_asset_id: null
                      background_colour: '#ffffff'
                    recipient:
                      id: 11111111-1111-4111-8111-000000000204
                      type: individual
                      first_name: Alex
                      last_name: Recipient
                      company_name: null
                      email: recipient-api-doc-list@incard.test
                      city: null
                      address_line_1: null
                      address_line_2: null
                      postcode: null
                      state: null
                      country: null
                      last_requested_at: null
                    reminderSchedule: null
                meta:
                  total: 1
                  take: 25
                  skip: 0
        '401':
          description: Unauthorized
        '403':
          description: Forbidden — insufficient permission for this user
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: access_token
      description: Short-lived access token. Obtain with your api_key.

````