Start a weekly payer follow-up
payer_follow_up_requestWeekly payer follow-up: we check every pending payer enrollment application with the payer until it is approved or denied (every 30 minutes, day and night, for payers that post their status online; the others every week, or as often as every business day with check_every_days), and tell you within one business day when a payer is missing a document; with the application bundle we first write and submit the application. Send an email, the plan and how you will give access (payer portal user, PECOS surrogate, delegation letter, CAQH admin invite, or call only). Group and per-application plans take the roster as NPIs and the pending applications (clinician NPI, payer, state, date submitted; payer reference number and notes optional). The application bundle takes applications_to_submit (clinician NPI, payer, state, and documents: caqh to use the clinician's CAQH profile, or send to send the license, malpractice certificate, W-9 and CV or work history; notes optional); where a payer requires the clinician's own signature, the clinician signs or attests. The reply has a Stripe checkout link and an access token, shown once, that opens the status later; nothing is checked until payment. A platform starting follow-ups for its own practices can keep every email from them with notify: platform_only (every email goes only to notify_email, its own address) or webhook_only (no email; status by the webhook). Group plan: $15 per clinician per month for the whole roster (weekly license, Medicare revalidation, exclusion list and NPI registry monitoring, only changes reported, plus a CAQH re-attestation and Medicare revalidation calendar), plus $149 per month for each clinician with a pending application, until all their applications are decided or six months. Per-application plan: $79 per application, checked until decided with no time limit; optional roster monitoring $3 per clinician per month. On the per-application plan and the application bundle, an application the payer never decides (no record on 3 checks in a row over at least 3 weeks, or 12 months without a decision) is stopped with an email and can be reopened at no charge within 30 days. Application bundle: $199 per application, paid up front, one checkout line per application, written, submitted and then checked until decided. Add webhook_url to get each status change as a signed POST (the reply carries webhook.secret once). Cancel subscriptions any time, from the next month. Not included: appeals, contract or rate negotiation. Up to 500 clinicians and 300 applications; up to 100 applications per bundle. Billing firms and software platforms get volume pricing, set up with us rather than at checkout. Book 20 minutes at https://calendly.com/licium/20-minutes or write to hello@licium.ai. Add partner_code if Licium gave you one. A request that cannot be used is refused with every field to fix at once (problems: field and error) and each unusable entry (invalid_entries), and nothing is saved.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| npis | No | The roster: 10-digit NPIs, up to 500. Every application's clinician is added to it. | |
| plan | Yes | group: monthly, $15 per roster clinician plus $149 per clinician with a pending application. per_application: $79 per application, one time, checked until decided with no time limit. application_bundle: $199 per application, one time, we write and submit it, then check it until decided; send applications_to_submit, not a roster or pending applications. | |
| Yes | |||
| access | Yes | How you will give access: payer portal user, PECOS surrogate, delegation letter, CAQH admin invite, or call_only by itself. | |
| notify | No | Optional. Who gets this follow-up's emails: practice (default) sends them to email; platform_only sends every email (payment confirmation, missing documents, document requests and reminders, roster changes, the Monday status email, stopped applications) only to notify_email, your platform's address, marked with the practice it is about, and never to email; webhook_only sends no email at all (webhook_url is required) and status reaches you by the webhook and GET /v1/payer-follow-ups/{id}. | |
| company | No | ||
| ref_code | No | ||
| caqh_text | No | The same dates as text: one line per clinician, NPI and date. | |
| monitoring | No | Per-application plan only: add roster monitoring at $3 per clinician per month. | |
| roster_text | No | The roster as text with NPIs anywhere in it; with or instead of npis. | |
| webhook_url | No | Optional. An HTTPS address on a public host (port 443 or 8443; no private, loopback, link-local or local addresses; at most 300 characters) that gets a signed POST each time an application's status changes. The reply carries webhook.secret, shown once. | |
| applications | No | Pending applications, one clinician with one payer each, up to 300. | |
| contact_time | No | Leave empty. | |
| notify_email | No | Required with notify platform_only, and only then: the address every email of this follow-up goes to instead of email. | |
| partner_code | No | Optional. A partner code Licium gave you: your agreed price is charged instead of the list price. A code that is not active is refused and nothing is saved. | |
| idempotency_key | No | Optional, sent as the Idempotency-Key header: 1 to 128 printable ASCII characters with no spaces. Retry with the same key, email and fields within 24 hours to get the first reply again instead of a second follow-up; that repeated reply has replayed true and access_token null (the token and any webhook secret are shown only in the first reply). The same key with different fields is refused (409). | |
| check_every_days | No | Optional, 1 to 7 (default 7, weekly): days between the checks of an application that are not reads of the payer's public status page (calls, emails, portal checks), always on a business day; 1 is every business day. For every application of the request, or set in an application entry for that one. The price does not change. Status pages are read every 30 minutes, day and night. | |
| applications_text | No | Pending applications as CSV or tab-separated lines: NPI, payer, state, date submitted, payer reference (optional), notes (optional); with or instead of applications. | |
| caqh_attestations | No | Optional CAQH last attestation dates for the deadline calendar (re-attestation is due 120 days later). | |
| applications_to_submit | No | application_bundle only: the applications to write and submit, one clinician with one payer each, up to 100. | |
| roster_from_provider_check | No | The request ID of a provider check sent from the same email; its NPIs join the roster. | |
| applications_to_submit_text | No | application_bundle only: the same as CSV or tab-separated lines: NPI, payer, state, documents (caqh or send), notes (optional); with or instead of applications_to_submit. |