> ## 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.

# Get outbound invoice

> Returns a single outbound invoice for the authenticated company. Requires permission `request_payments`.



## OpenAPI

````yaml /specs/company.openapi.yaml get /developer/company/invoices/{id}
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/{id}:
    get:
      tags:
        - INVOICES
      summary: Get outbound invoice
      description: >-
        Returns a single outbound invoice for the authenticated company.
        Requires permission `request_payments`.
      operationId: get_outbound_invoice
      parameters:
        - name: id
          in: path
          required: true
          description: Outbound invoice UUID.
          schema:
            type: string
      responses:
        '200':
          description: Outbound invoice with template, recipient, and requester details.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    description: Whether the invoice was returned successfully.
                    type: boolean
                  data:
                    type: object
                    properties:
                      invoice:
                        type: object
                        properties:
                          id:
                            description: Outbound invoice UUID.
                            type: string
                          company_id:
                            description: Company UUID that owns the invoice.
                            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
                          invoice_number:
                            description: Merchant-facing invoice number.
                            type: string
                          reference:
                            description: Invoice reference.
                            type: string
                          deposit_account_id:
                            description: Deposit account UUID.
                            type: string
                          currency:
                            description: Invoice currency code.
                            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
                          memo:
                            description: Invoice memo, or null when not provided.
                            type: string
                          template_id:
                            description: Invoice template UUID.
                            type: string
                          recipient_id:
                            description: Recipient contact UUID.
                            type: string
                          email:
                            description: Recipient email address.
                            type: string
                          cc:
                            description: CC recipients.
                            type: array
                            items:
                              type: object
                          notes:
                            description: Invoice notes.
                            type: string
                          transaction_id:
                            description: Linked transaction UUID, or null when not linked.
                            type: string
                          cancelled_at:
                            description: >-
                              Cancellation timestamp, or null when not
                              cancelled.
                            format: date-time
                            type: string
                          requested_by:
                            type: object
                            properties:
                              id:
                                description: Requester user UUID.
                                type: string
                              first_name:
                                description: Requester first name.
                                type: string
                              last_name:
                                description: Requester last name.
                                type: string
                              email:
                                description: Requester email address.
                                type: string
                          template:
                            type: object
                            properties:
                              id:
                                description: Template UUID.
                                type: string
                              company_id:
                                description: Template owner company UUID.
                                type: string
                              name:
                                description: Template name.
                                type: string
                              background_type:
                                description: Template background type.
                                type: string
                              background_colour:
                                description: Template background colour.
                                type: string
                              background_asset_id:
                                description: >-
                                  Template background asset UUID, or null when
                                  absent.
                                type: string
                              updated_at:
                                description: Template update timestamp.
                                format: date-time
                                type: string
                              updated_by:
                                description: Template updater UUID, or null when absent.
                                type: string
                            required:
                              - id
                              - company_id
                              - name
                          recipient:
                            type: object
                            properties:
                              id:
                                description: Recipient UUID.
                                type: string
                              company_id:
                                description: Recipient owner company UUID.
                                type: string
                              type:
                                description: Recipient type.
                                type: string
                              first_name:
                                description: Recipient first name.
                                type: string
                              last_name:
                                description: Recipient last name.
                                type: string
                              company_name:
                                description: >-
                                  Recipient company name, or null for
                                  individuals.
                                type: string
                              email:
                                description: Recipient email address.
                                type: string
                              address_line_1:
                                description: Recipient address line 1.
                                type: string
                              address_line_2:
                                description: Recipient address line 2.
                                type: string
                              city:
                                description: Recipient city.
                                type: string
                              postcode:
                                description: Recipient postcode.
                                type: string
                              state:
                                description: Recipient state.
                                type: string
                              country:
                                description: Recipient country.
                                type: string
                              last_requested_at:
                                description: Last request timestamp, or null when absent.
                                format: date-time
                                type: string
                              updated_at:
                                description: Recipient update timestamp.
                                format: date-time
                                type: string
                              updated_by:
                                description: Recipient updater UUID, or null when absent.
                                type: string
                            required:
                              - id
                              - company_id
                              - type
                          reminderSchedule:
                            description: >-
                              Active reminder schedule, or null when none is
                              configured.
                            type: object
                        required:
                          - id
                          - company_id
                          - public_id
                          - status
                          - due_date
                          - issued_at
                          - invoice_number
                          - deposit_account_id
                          - currency
                          - amount
                          - line_items
                          - template_id
                          - recipient_id
                          - email
                          - cc
                required:
                  - success
                title: OutboundInvoice
              example:
                success: true
                data:
                  invoice:
                    id: 11111111-1111-4111-8111-000000000306
                    company_id: 11111111-1111-4111-8111-000000000301
                    public_id: invoice_api_doc_get_001
                    status: pending
                    due_date: '2027-02-01T00:00:00.000Z'
                    issued_at: '2027-01-01T00:00:00.000Z'
                    invoice_number: INV-API-DOC-001
                    reference: API documentation example
                    deposit_account_id: 11111111-1111-4111-8111-000000000303
                    currency: GBP
                    amount: 100
                    line_items:
                      - quantity: 1
                        unit_price: 100
                        discount: 0
                        description: Integration test line item
                    memo: null
                    template_id: 11111111-1111-4111-8111-000000000305
                    recipient_id: 11111111-1111-4111-8111-000000000304
                    email: billing@incard.test
                    cc: []
                    notes: Created for API documentation examples.
                    transaction_id: null
                    cancelled_at: null
                    requested_by:
                      id: 11111111-1111-4111-8111-000000000302
                      first_name: Integration
                      last_name: Tester
                      email: integration-tester@incard.test
                    template:
                      id: 11111111-1111-4111-8111-000000000305
                      company_id: 11111111-1111-4111-8111-000000000301
                      name: Template api-doc-get
                      background_type: colour
                      background_colour: '#ffffff'
                      background_asset_id: null
                      updated_at: '2027-01-01T00:00:00.000Z'
                      updated_by: null
                    recipient:
                      id: 11111111-1111-4111-8111-000000000304
                      company_id: 11111111-1111-4111-8111-000000000301
                      type: individual
                      first_name: Alex
                      last_name: Recipient
                      company_name: null
                      email: recipient-api-doc-get@incard.test
                      address_line_1: null
                      address_line_2: null
                      city: null
                      postcode: null
                      state: null
                      country: null
                      last_requested_at: null
                      updated_at: '2027-01-01T00:00:00.000Z'
                      updated_by: null
                    reminderSchedule: null
        '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.

````