---
title: "Get egress invoice"
method: GET
path: "/invoices/egress/{id}"
tags: ["Invoices"]
---

# Get egress invoice

`GET /invoices/egress/{id}`

Retrieve a specific egress invoice by ID.

**gigstack Connect:** Access other teams' invoices using the `team` parameter.

## Path parameters

- `id` string, required

## Query parameters

- `team` string

## Response `200`

Invoice retrieved successfully

- object
  - `message` string
  - `data` ApiPublicIncomeInvoice
    - `uuid` string — Invoice UUID
    - `client` ApiPublicClient
      - `id` string, required — Unique client identifier
      - `address` ClientAddress, nullable
        - `country` string, nullable
        - `street` string, nullable
        - `zip` string, nullable
        - `city` string, nullable
        - `state` string, nullable
        - `exterior` string, nullable
        - `interior` string, nullable
        - `municipality` string, nullable
        - `neighborhood` string, nullable
      - `name` string, nullable — Client name
      - `company` string, nullable — Client company name
      - `phone` string, nullable — Client phone number
      - `email` string, email, nullable, required — Client email address
      - `bcc` string[], nullable — BCC email addresses for client communications
      - `metadata` object, nullable — Additional metadata for the client
      - `is_valid` boolean, nullable — Whether the client data is valid
      - `from` string, required — Source of client creation
      - `legal_name` string, nullable — Legal name for tax purposes
      - `livemode` boolean, required — Whether this client is in live mode
      - `owner` string, required — User ID who owns this client
      - `tax_id` string, nullable — RFC (Tax ID) for Mexican tax compliance
      - `use` string, nullable — CFDI use code
      - `tax_system` string, nullable — SAT tax system code
      - `team` string, required — Team ID this client belongs to
      - `created_at` number, required — Unix timestamp of client creation
      - `efos` object, nullable — EFOS (SAT blacklist) validation status
        - `is_valid` boolean, nullable — Whether the client is valid according to SAT EFOS list
      - `defaults` object, nullable — Client default settings
        - `keep_full_legal_name` boolean, nullable — Keep full legal name in documents
        - `issue_automatic_invoices` boolean, nullable — Issue automatic invoices
        - `issue_invoiceable_receipts` boolean, nullable — Issue invoiceable receipts
    - `created_at` number — Invoice creation timestamp
    - `currency` string — Invoice currency
    - `exchange_rate` number — Exchange rate used
    - `total` number — Total invoice amount
    - `subtotal` number — Subtotal before taxes
    - `taxes` number — Total tax amount
    - `discount` number — Total discount amount
    - `withholding_taxes` number — Total withholding tax amount
    - `series` string — Invoice series
    - `folio_number` number — Invoice folio number
    - `invoice_type` 'I' | 'E' | 'P' | 'N' — Invoice type (I=Income, E=Egress, P=Payment, N=Nomina)
    - `use` string — Mexican SAT usage code
    - `payment_form` string — Mexican SAT payment form code
    - `payment_method` string — Payment method (PUE/PPD)
    - `status` 'draft' | 'pending' | 'stamped' | 'cancelled' — Invoice status
    - `livemode` boolean — Whether this is a live invoice
    - `owner` string — User who created the invoice
    - `from` string — Source of invoice creation
    - `items` object[]
      - `id` string
      - `description` string
      - `product_key` string
      - `quantity` number
      - `unit_price` number
      - `unit_key` string
      - `unit_name` string
      - `sku` string
      - `taxability` '01' | '02'
      - `taxes` TaxSchema[]
        - `base` union — Taxable base amount. Accepts number or numeric string. If null, calculated automatically from item price.
          - number
          - string
        - `factor` string, nullable
        - `inclusive` boolean, nullable
        - `rate` number, nullable
        - `type` 'IVA' | 'ISR' | 'IEPS', nullable
        - `withholding` boolean, nullable
    - `payments` string[] — Associated payment IDs
    - `invoices` string[] — Related invoice IDs
    - `stamp` object, nullable
      - `sello` string
      - `stamp_at` number
    - `cancellation` object, nullable
      - `cancellation_status` string
      - `cancelled_at` number
      - `motive` string
      - `code` string
    - `verification_url` string — SAT verification URL
    - `exports` string — Export indicator
    - `addenda` string — Additional XML addenda
    - `invoice_pdf_notes` string — Custom notes for PDF generation
    - `files` object, nullable — Base64 encoded files (only returned when return_files=true)
      - `pdf` string — Base64 encoded PDF file
      - `xml` string — Base64 encoded XML file

---

[API](https://skmtc.net/disruptive-learning/apis/gigstack-api-v2.md) · [All operations](https://skmtc.net/disruptive-learning/apis/gigstack-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/disruptive-learning/gigstack-api-v2/versions/5cf53ffd7580/schema)