Pre-Auth List

Returns normalized pre-authorization records for a customer and insurance slug.

GET /pre-auth-list

Inputs

name	required	in	type	aliases	default	description
insurance	yes	query	string	ins		Insurance slug (ma, razi, asia, ...).
confirm_from	yes	query	int	from		Confirm date start as unix timestamp (seconds).
confirm_to	yes	query	int	to		Confirm date end as unix timestamp (seconds).
skip	no	query	int		0	Pagination offset.
top	no	query	int		20	Pagination size.

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.count	int	Returned item count.
meta.total	int\|null	Provider total count when available.
data[]	object	Normalized pre-auth records.
data[].pre_auth_id	int\|null	Pre-auth identifier.
data[].index	int\|null	Item index in provider result.
data[].status.slug	string\|null	Pre-auth status slug.
data[].status.label	string\|null	Pre-auth status label.
data[].confirm_date	int\|null	Confirm date as unix timestamp.
data[].policy.id	int\|null	Policy identifier.
data[].insured_person.full_name	string\|null	Insured person full name.
data[].illness.type_slug	string\|null	Illness type slug.
data[].illness.slug	string\|null	Illness slug.
data[].amounts.amount	float\|null	Requested amount.
data[].flags.cancel_enabled	bool\|null	Cancel action enabled.

Examples

Success

Request

GET /pre-auth-list?insurance=ma&confirm_from=1700000000&confirm_to=1700086400&skip=0&top=20

Response

{
    "ok": true,
    "provider": "mad",
    "insurance": "ma",
    "meta": {
        "provider_status": 200,
        "count": 1,
        "total": 1
    },
    "data": [
        {
            "pre_auth_id": 9001,
            "index": 1,
            "status": {
                "slug": "approved",
                "label": "Approved"
            },
            "confirm_date": 1700086400,
            "policy": {
                "id": 5001,
                "number": 18,
                "full_number": "12345678\/00\/000018"
            },
            "insured_person": {
                "id": 3001,
                "full_name": "Example Person",
                "national_code": "1234567890",
                "passport_no": null,
                "naturalized_code": null
            },
            "illness": {
                "type_slug": "outpatient",
                "type_label": "Outpatient",
                "slug": "lab_tests",
                "label": "Lab Tests",
                "description": "Kidney"
            },
            "customer": {
                "id": 1001,
                "full_name": "Example Customer"
            },
            "amounts": {
                "amount": 1234500,
                "paid": 0,
                "estimate": 1234500
            },
            "op_unit_name": "Example Unit",
            "deductible_rate": 10,
            "flags": {
                "has_details": false,
                "submitted_with_child": false,
                "edit_release_enabled": false,
                "print_enabled": true,
                "print_expertise_sheet_enabled": false,
                "release_enabled": false,
                "submission_for_approval_enabled": true,
                "cancel_enabled": true
            },
            "cancellation_desc": null
        }
    ]
}