Skip to main content
POST
Submit Pre-auth

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
request_type
string
required
auth_type
string
clinical_notes
string

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
items
object[]

Carries the client-supplied deltas per procedure line: speciality code, procedure code, claim amount, optional stratification code, supporting docs, and questionnaire answers. Names/costs/mandatory-docs are enriched server-side from the case's catalog (catalog_md5).

planned_end_date
null | string<date-time>
planned_start_date
null | string<date-time>
treating_doctor
object

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

user_token
string

Response

OK

estimated_response_time
string

e.g., "4-6 hours"

message
string
request_id
string
status
string
workflow_id
string

Current workflow state