---
title: "List support documents"
method: GET
path: "/invoices/{id}/support-documents"
tags: ["Invoices"]
---

# List support documents

`GET /invoices/{id}/support-documents`

Retrieve all supporting documents attached to an invoice.

**gigstack Connect:** View documents for other teams' invoices using the `team` parameter.

Documents are returned sorted by creation date (newest first).

## Path parameters

- `id` string, required

## Query parameters

- `team` string

## Response `200`

Documents retrieved successfully

- object
  - `success` boolean
  - `data` SATDocument[]
    - `id` string, required — Unique document identifier
    - `document_type` 'contract' | 'delivery_proof' | 'payment_proof' | 'communication' | 'payment_confirmation' | 'subscription_info' | 'cronograma', required — Type of supporting document
    - `name` string, required — Document name
    - `description` string, nullable — Optional document description
    - `file_url` string, uri, required — Public URL to access the document
    - `file_name` string, required — Original filename
    - `file_size` integer, required — File size in bytes
    - `mime_type` string, required — MIME type of the file
    - `compliance_status` 'pending_review' | 'valid' | 'requires_update' | 'expired' | 'rejected', required — SAT compliance status
    - `compliance_notes` string, nullable — Notes about compliance status
    - `valid_from` integer, nullable — Validity start timestamp (milliseconds)
    - `valid_until` integer, nullable — Validity end timestamp (milliseconds)
    - `ai_extraction` object, nullable — AI extraction results if analyzed
      - `extracted_at` integer — Extraction timestamp (milliseconds)
      - `extracted_by` string — Source of extraction
      - `model` string — AI model used
      - `confidence` number, float — Confidence score (0-1)
      - `extracted_data` object — Extracted structured data
      - `warnings` string[] — Extraction warnings
    - `audits` object[] — Context-specific audit results
      - `context_type` 'invoice' | 'payment' | 'receipt' — Type of entity audited against
      - `context_id` string — ID of entity audited against
      - `audited_at` integer — Audit timestamp (milliseconds)
      - `result` 'valid' | 'warning' | 'mismatch' — Audit result
      - `summary` string — Audit summary
      - `details` object — Detailed audit results
    - `created_at` integer, required — Creation timestamp (milliseconds)
    - `created_by` string — User who created the document
    - `updated_at` integer — Last update timestamp (milliseconds)
    - `linked_entities` object[], required — Entities this document is linked to
      - `entity_type` 'invoice' | 'payment' | 'receipt' | 'client' — Type of linked entity
      - `entity_id` string — ID of linked entity
      - `linked_at` integer — Link timestamp (milliseconds)
  - `message` string
  - `timestamp` string, date-time

## Other responses

- `401` — Unauthorized
- `404` — Invoice not found

---

[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)