Insured Person Info

Returns normalized insured person profile by cmnid (computer code).

GET /insured-person-info

Inputs

name	required	in	type	aliases	default	description
insurance	yes	query	string	ins		Insurance slug (ma, razi, asia, ...).
cmnid	yes	query	int	cmnId, cmn_id		Insured person computer code (cmnId).
policy_id	yes	query	int	policyId		Policy identifier.
health_policy_insured_person_id	yes	query	int	healthPolicyInsuredPersonId, policy_link_id, policyLinkId		Health policy insured person ID (policy link ID).
illness_id	no	query	int	illnessId	101	Illness identifier.
reception_date	no	query	string	receptionDate		Reception date in Jalali format (Y/m/d). Defaults to today.

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.
meta.franshiz_rate	int\|null	Franshiz rate from provider.
meta.remain_amount	int\|null	Accessible remain amount from provider.
data.cmn_id	int\|null	Computer code (cmnId).
data.birth_year	int\|null	Birth year (Jalali).
data.gender.slug	string\|null	Gender slug.
data.gender.label	string\|null	Gender label.
data.identity_no	string\|null	Identity number.
data.national_code	string\|null	National code.
data.first_name	string\|null	First name.
data.last_name	string\|null	Last name.
data.is_iranian	bool\|null	Iranian citizenship flag.
data.passport_no	string\|null	Passport number.
data.naturalized_code	string\|null	Naturalized code.

Examples

Success

Request

GET /insured-person-info?insurance=asia&cmnid=123456

Response

{
    "ok": true,
    "provider": "mad",
    "insurance": "asia",
    "meta": {
        "provider_status": 200
    },
    "data": {
        "cmn_id": 123456,
        "birth_year": 1400,
        "gender": {
            "slug": "male",
            "label": "Male"
        },
        "identity_no": "1234567890",
        "national_code": "1234567890",
        "first_name": "Example",
        "last_name": "Person",
        "is_iranian": true,
        "passport_no": null,
        "naturalized_code": null
    }
}