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, ... , dana).
policy_id	yes	body	int	policyId		Policy identifier.
insured_person_policy_ver_no	no	body	int	insuredPersonPolicyVerNo	1	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 as Unix timestamp (preferred) or Jalali (Y/m/d). Defaults to today.
doctor_name	no	body	string	doctorName	''	Doctor name (required for MAD, optional for Dana).
mc_specialty	no	body	string	mCSpecialty, mcSpecialty	''	Medical center specialty text (MAD flow).
doctor_code	no	body	string	doctorCode, shomareNezamPezeshki, doctor_code	''	Doctor code (required for Dana).
takhasos_pezeshk_id	no	body	int	takhasosPezeshkId, doctorSpecialtyId, takhasos_pezeshk_id	0	Doctor specialty ID from Dana Takhasos list (required for Dana).
comment	no	body	string	comment		Comment.
first_insurer_id	no	body	int	firstInsurerId	0	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	no	body	int	illnessTypeId	35	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
    }
}

Success (Dana)

Request

POST /pre-auth-registration?insurance=dana

Response

{
    "ok": true,
    "provider": "dana",
    "insurance": "dana",
    "meta": {
        "provider_status": 200
    },
    "data": {
        "pre_auth_id": 57462348,
        "policy_id": 38889943,
        "insured_person_id": 37306159,
        "amount": 1000000,
        "franchise": 10,
        "status": null
    }
}