---
title: "A credentialing firm's view, with the firm ID and the firm's access token: each client practice it runs a weekly payer follow-up for (open, decided and missing-document counts, the next check, its report) and every pending application across them in one list, the ones waiting on a practice first, each as the practice's report shows it. Add ?format=csv or ?format=xlsx for every application (pending, and decided in the last 30 days) as a spreadsheet, one row per application, ready to paste into Smartsheet or Excel."
method: GET
path: "/v1/payer-follow-ups/firms/{firmId}"
tags: ["Payer follow-ups", "Payments"]
---

# A credentialing firm's view, with the firm ID and the firm's access token: each client practice it runs a weekly payer follow-up for (open, decided and missing-document counts, the next check, its report) and every pending application across them in one list, the ones waiting on a practice first, each as the practice's report shows it. Add ?format=csv or ?format=xlsx for every application (pending, and decided in the last 30 days) as a spreadsheet, one row per application, ready to paste into Smartsheet or Excel.

`GET /v1/payer-follow-ups/firms/{firmId}`

## Request

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

Send the firm's access token (header X-Payer-Follow-Up-Token, Authorization: Bearer, or ?token=), or use a session signed in with the firm's email. The same token opens each of the firm's practices: GET /v1/payer-follow-ups/{id} and GET /v1/payer-follow-ups/{id}/report. applications lists every pending application, missing documents first, then no record, then by next check; recently_decided lists those decided in the last 30 days.

## Path parameters

- `firmId` string, uuid, required

## Query parameters

- `token` string
- `format` 'json' | 'csv' | 'xlsx'

## Headers

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

## Response `200`

The firm's practices and pending applications, or with format csv or xlsx every application (pending, then decided in the last 30 days) as a spreadsheet file.

- object
  - `success` unknown
  - `data` object
    - `firm` object
      - `id` string, uuid
      - `name` string
      - `reply_to_email` string
      - `callback_number` string, nullable
      - `sample` boolean
      - `notices_to` 'practice' | 'firm_first': Where the practices' notices go first.
    - `generated_at` string
    - `week_of` string, date
    - `summary` object
      - `practices` integer
      - `open` integer
      - `needs_documents` integer
      - `changed_this_week` integer
      - `decided` integer
    - `practices` object[]
      - `account_id` string, uuid
      - `practice` string
      - `sample` boolean
      - `standing` 'awaiting_payment' | 'active' | 'paused' | 'ended' | 'payment_problem'
      - `open` integer
      - `decided` integer
      - `needs_documents` integer
      - `changed_this_week` integer
      - `next_check_on` string, date, nullable
      - `report_path` string
    - `applications` object[]
      - `id` string, uuid
      - `clinician` string, nullable
      - `npi` string
      - `payer` string
      - `state` string
      - `submitted_on` string, date, nullable
      - `to_submit` boolean: An application we write and submit, not submitted yet.
      - `status` 'not_checked' | 'received' | 'in_review' | 'needs_documents' | 'approved' | 'denied' | 'no_record'
      - `status_label` string
      - `payer_words` string, nullable: The status in the payer's own words: its page's words, the representative's, or what was written down.
      - `status_date` string, nullable: The date the payer's page gives with that status, as shown.
      - `expected_decision` string, nullable: When a representative said a decision is expected, as said.
      - `note` string, nullable: What the person who recorded it wrote down, when payer_words came from the payer's page.
      - `effective_date` string, date, nullable
      - `reference` string, nullable: The application's number with the payer, or null.
      - `source` object, nullable
        - `kind` 'status_page' | 'call' | 'person'
        - `label` string
        - `url` string, nullable
        - `at` string
        - `rep_name` string, nullable
        - `call_reference` string, nullable
        - `note` string, nullable
        - `method` 'portal' | 'phone' | 'email'
      - `missing` string, nullable
      - `waiting_on` 'payer' | 'practice' | 'nobody'
      - `next_step` string
      - `last_checked_at` string, nullable
      - `next_check_on` string, date, nullable
      - `changed_this_week` boolean
      - `history` object[]
        - `checked_at` string
        - `status` string
        - `status_label` string
        - `payer_words` string, nullable
        - `source_kind` 'status_page' | 'call' | 'person'
        - `source_label` string
        - `rep_name` string, nullable
        - `call_reference` string, nullable
      - `status_check_page` string, nullable: The page POST /v1/payer-follow-ups/status-check reads for this payer in this state, or null.
      - `account_id` string, uuid
      - `practice` string
    - `recently_decided` object[]
      - `id` string, uuid
      - `clinician` string, nullable
      - `npi` string
      - `payer` string
      - `state` string
      - `submitted_on` string, date, nullable
      - `to_submit` boolean: An application we write and submit, not submitted yet.
      - `status` 'not_checked' | 'received' | 'in_review' | 'needs_documents' | 'approved' | 'denied' | 'no_record'
      - `status_label` string
      - `payer_words` string, nullable: The status in the payer's own words: its page's words, the representative's, or what was written down.
      - `status_date` string, nullable: The date the payer's page gives with that status, as shown.
      - `expected_decision` string, nullable: When a representative said a decision is expected, as said.
      - `note` string, nullable: What the person who recorded it wrote down, when payer_words came from the payer's page.
      - `effective_date` string, date, nullable
      - `reference` string, nullable: The application's number with the payer, or null.
      - `source` object, nullable
        - `kind` 'status_page' | 'call' | 'person'
        - `label` string
        - `url` string, nullable
        - `at` string
        - `rep_name` string, nullable
        - `call_reference` string, nullable
        - `note` string, nullable
        - `method` 'portal' | 'phone' | 'email'
      - `missing` string, nullable
      - `waiting_on` 'payer' | 'practice' | 'nobody'
      - `next_step` string
      - `last_checked_at` string, nullable
      - `next_check_on` string, date, nullable
      - `changed_this_week` boolean
      - `history` object[]
        - `checked_at` string
        - `status` string
        - `status_label` string
        - `payer_words` string, nullable
        - `source_kind` 'status_page' | 'call' | 'person'
        - `source_label` string
        - `rep_name` string, nullable
        - `call_reference` string, nullable
      - `status_check_page` string, nullable: The page POST /v1/payer-follow-ups/status-check reads for this payer in this state, or null.
      - `account_id` string, uuid
      - `practice` string
    - `authorized_by` 'token' | 'session' | 'ops'

## Other responses

- `400`: format must be json, csv or xlsx.
- `401`: Send the firm's access token, or sign in with the firm's email.
- `404`: Firm not found, or the token does not open it.
- `429`: Too many requests. Try again in one hour.
- `503`: Could not read the firm's practices. 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)