Documents API

List bill documents

List every document currently included in the payer billing packet.

GEThttps://app.mindbill.org/partner/v2/bills/{billId}/documents

Inspect or reconcile the exact document packet frozen onto a submitted bill.

AuthenticationServer API key or browser session + Origin

Permissions by credentialServer: bills:read · Browser: documents:read

IdempotencyNot required

Use this URL with a server API key or a browser session and its exact allowed Origin. Both credentials use the same request and response contract. See the component API inventory for exact paths and SDK methods.

Path parameters

FieldTypeDescription

billIdRequired

string

The MindBill bill identifier returned after atomic submission.

Examples

curl https://app.mindbill.org/partner/v2/bills/$BILL_ID/documents \
  --header "Authorization: Bearer $MINDBILL_API_KEY"

Response

200 OK

{
  "data": [{
    "id": "doc_01J6Z1",
    "externalId": "document_73",
    "filename": "final-report.pdf",
    "description": "Final medical-legal report",
    "documentType": "final_report",
    "source": "partner_api",
    "addedAt": "2026-08-29T18:20:00.000Z",
    "contentUrl": "https://app.mindbill.org/..."
  }]
}

FieldTypeDescription

data[].idRequired

string

MindBill document identifier.

data[].externalIdRequired

string | null

Your document identifier when supplied.

data[].filenameRequired

string

Filename shown during packet review.

data[].descriptionRequired

string | null

Human-readable packet description.

data[].documentTypeRequired

BillDocumentType

Document classification.

data[].sourceRequired

string

How the document entered the bill.

data[].addedAtRequired

string

ISO timestamp when the document was attached.

data[].contentUrlRequired

string

Authorized content URL.