Pre-Auth Registration

Registers a pre-authorization request and returns normalized registration data.

POST /pre-auth-registration

Inputs

name	required	in	type	aliases	default	description
insurance	yes	query	string	ins		Insurance slug (ma, razi, asia, ...).
policy_id	yes	body	int	policyId		Policy identifier.
insured_person_policy_ver_no	yes	body	int	insuredPersonPolicyVerNo		Insured person policy version number.
insured_person_id	yes	body	int	insuredPersonId		Insured person identifier.
illness_desc	no	body	string	illnessDesc		Illness description.
reception_date	no	body	string	receptionDate		Reception date in Jalali format (Y/m/d). Defaults to today.
doctor_name	yes	body	string	doctorName		Doctor name.
mc_specialty	yes	body	string	mCSpecialty, mcSpecialty		Medical center specialty.
comment	no	body	string	comment		Comment.
first_insurer_id	yes	body	int	firstInsurerId		First insurer identifier.
is_for_accident	no	body	bool	isForAccident	false	Accident flag.
amount	yes	body	float	amount		Requested amount.
illness_id	yes	body	int	illnessId		Illness identifier.
illness_type_id	yes	body	int	illnessTypeId		Illness type identifier.
left_eye_dioptre	no	body	float	leftEyeDioptre		Left eye dioptre.
right_eye_dioptre	no	body	float	rightEyeDioptre		Right eye dioptre.

Response Format

path	type	description
ok	bool	True on success.
error	string\|null	Error message when ok=false.
provider	string	Selected provider key.
insurance	string	Insurance slug.
meta.provider_status	int\|null	Provider HTTP status.
data.pre_auth_id	int\|null	Pre-auth identifier.
data.policy_id	int\|null	Policy identifier.
data.insured_person_id	int\|null	Insured person identifier.
data.amount	float\|null	Requested amount.
data.franchise	float\|null	Franchise rate.
data.status	int\|null	Status code.

Examples

Success

Request

POST /pre-auth-registration

Response

{
    "ok": true,
    "provider": "mad",
    "insurance": "ma",
    "meta": {
        "provider_status": 200
    },
    "data": {
        "pre_auth_id": 90001,
        "policy_id": 10001,
        "insured_person_id": 123456,
        "amount": 1250000,
        "franchise": 20,
        "status": 102
    }
}