Skip to main content
POST
Preview Claim Bundle

Authorizations

Authorization
string
header
required

The API requires a Bearer token (JWT) for authentication.

Headers

X-Pt-Id
string

Eka User ID (OID)

X-Partner-Pt-Id
string

Partner User ID

X-Hip-Id
string

Partner HIP ID

Path Parameters

claimId
integer
required

claim_id returned by Create Claim

Required range: x >= 0

Body

application/json
admission_date
null | string<date-time>

Optional: when supplied, each claim item's servicedPeriod spans admission..discharge (the full IPD stay). The case does not currently capture an admission date, so without this the item falls back to the discharge date alone as its serviced date.

auth_type
string
care_team_members
object[]

NOT case-derivable — supplied by the caller (HMIS) per submission.

Beneficiary authentication. AuthType "consent" (default) sends the Authentication Consent Questionnaire response (Consent) and OMITS the biometric X-Token; "biometric" sends UserToken as the X-Token.

diagnosis
object[] | null

The discharge diagnosis — NOT case-derivable (may differ from the pre-auth diagnosis), supplied by the caller.

discharge_date
null | string<date-time>
discharge_stage
string

DIS valueString: "After surgery"(default) | ...

discharge_type
string

"home"(default) | "mortuary" | "lama" | "dama"

itemized_billing
object[]

Carries the client-supplied deltas per line item: service_code, quantity, unit_price. Category/display are optionally enriched server-side from the case's catalog (catalog_md5); TotalAmount and the overall ClaimedAmount are always server-computed.

remarks
string

Free text; mandatory once the claim is submitted >15 days post-discharge. See validateClaimRequest's TAT-band check.

request_type
string

Selects the NHCX workflow for this claim submission, mirroring preauth: "" / "InitialRequest" → first/final claim submit (workflow 15) "QueryResponse" → answer a payer query on this claim (workflow 151) "Resubmission"/"FollowUp" → resubmit a rejected claim (workflow 16) A QueryResponse/Resubmission reuses the SAME Claim.identifier (the payer's CLN, stored on the claim as claim_ref) so the payer links it to the queried/rejected claim — the correlation id is fresh per exchange, linkage is CLN + workflow id (NHCX bundle-anatomy). Empty = initial.

supporting_docs
object[]
user_token
string

Response

OK

{key}
any