---
title: "Application bundle: read the documents we need to write and submit the applications, with the account ID and the access token. For each clinician whose documents you send: the state license, malpractice certificate, W-9 and CV with work history, a DEA registration for prescribers, and board certification if certified; for each clinician whose documents come from CAQH, or whose payer works from the CAQH profile: the CAQH ID and access for Licium; and once for the group, the IRS letter with its Tax ID. Each document has its status (needed, received, accepted, or needs_resend with the reason) and the type and size of what was sent. The list opens when payment settles."
method: GET
path: "/v1/payer-follow-ups/{id}/documents"
tags: ["Payer follow-ups", "Payments"]
---

# Application bundle: read the documents we need to write and submit the applications, with the account ID and the access token. For each clinician whose documents you send: the state license, malpractice certificate, W-9 and CV with work history, a DEA registration for prescribers, and board certification if certified; for each clinician whose documents come from CAQH, or whose payer works from the CAQH profile: the CAQH ID and access for Licium; and once for the group, the IRS letter with its Tax ID. Each document has its status (needed, received, accepted, or needs_resend with the reason) and the type and size of what was sent. The list opens when payment settles.

`GET /v1/payer-follow-ups/{id}/documents`

## Request

- Base URL: `https://www.licium.ai`
- URL: `https://www.licium.ai/v1/payer-follow-ups/{id}/documents`
- Auth: none required

Same access as the status read: the access token (header X-Payer-Follow-Up-Token, Authorization: Bearer, or ?token= as in emailed links) or a session signed in with the follow-up's email. Only a paid application bundle has documents; any other follow-up returns an empty list and next says why. Each document: kind (state_license, malpractice, w9, cv_work_history, dea, board_certification, caqh_authorization, group_tin_letter), label, hint (what it must show), required (false: only if it applies, such as DEA while we do not know whether the clinician prescribes), status, uploaded_at, reviewed_at, note (needs_resend only: why we ask again), file (type and size of what was sent; never its name) and caqh_id (caqh_authorization only).

## Path parameters

- `id` string, uuid, required

## Query parameters

- `token` string

## Headers

- `X-Payer-Follow-Up-Token` string

## Response `200`

The documents.

- object
  - `success` unknown
  - `data` object
    - `account_id` string, uuid
    - `accepting` boolean: Documents can be sent now: a paid application bundle.
    - `clinicians` object[]
      - `npi` string
      - `name` string, nullable
      - `applications` object[]
        - `payer` string
        - `state` string
        - `documents_from` 'caqh' | 'send'
      - `documents` PayerFollowUpDocument[]
        - `id` string, uuid
        - `kind` 'state_license' | 'malpractice' | 'w9' | 'cv_work_history' | 'dea' | 'board_certification' | 'caqh_authorization' | 'group_tin_letter'
        - `label` string
        - `hint` string: What the document must show.
        - `required` boolean: false: only if it applies (DEA while we do not know whether the clinician prescribes; board certification).
        - `status` 'needed' | 'received' | 'accepted' | 'needs_resend'
        - `uploaded_at` string, nullable
        - `reviewed_at` string, nullable
        - `note` string, nullable: needs_resend only: why we ask for it again.
        - `file` object, nullable
          - `type` 'application/pdf' | 'image/jpeg' | 'image/png'
          - `bytes` integer
        - `caqh_id` string, nullable: caqh_authorization only.
        - `version` integer: How many times it has been sent; 0 while needed.
    - `group` PayerFollowUpDocument[]: The group's own documents (its IRS Tax ID letter).
      - `id` string, uuid
      - `kind` 'state_license' | 'malpractice' | 'w9' | 'cv_work_history' | 'dea' | 'board_certification' | 'caqh_authorization' | 'group_tin_letter'
      - `label` string
      - `hint` string: What the document must show.
      - `required` boolean: false: only if it applies (DEA while we do not know whether the clinician prescribes; board certification).
      - `status` 'needed' | 'received' | 'accepted' | 'needs_resend'
      - `uploaded_at` string, nullable
      - `reviewed_at` string, nullable
      - `note` string, nullable: needs_resend only: why we ask for it again.
      - `file` object, nullable
        - `type` 'application/pdf' | 'image/jpeg' | 'image/png'
        - `bytes` integer
      - `caqh_id` string, nullable: caqh_authorization only.
      - `version` integer: How many times it has been sent; 0 while needed.
    - `summary` object
      - `required` integer
      - `missing` integer: Required documents not sent yet or asked for again.
      - `received` integer
      - `accepted` integer
      - `needs_resend` integer
    - `request_email` object
      - `sent_at` string, nullable
      - `reminder_sent_at` string, nullable
    - `upload` object
      - `types` string[]
      - `max_bytes` integer: Multipart form data.
      - `max_base64_bytes` integer: JSON with file_base64, once decoded.
    - `next` string
    - `authorized_by` 'token' | 'session' | 'ops'

## Other responses

- `401`: Send the access token, or sign in with the follow-up's email.
- `404`: Follow-up not found, or the token does not open it.
- `429`: Too many requests. Try again in one hour.
- `503`: Could not read the documents. Try again in a minute.

---

[API](https://skmtc.dev/licium/apis/licium-public-api.md) · [All operations](https://skmtc.dev/licium/apis/licium-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/licium/apis/licium-public-api/revisions/d91a72f755f4?raw)