Fetch Audit Results for a Single Expense Report

To Fetch the Audit Results for a Single Expense Report. For calling the API, you will need the access token. 

Request URI 

GET https://api.appzen.com/expense-audit-results/v2/reports/{{external-report-id}}

Header Parameters

Path Parameters

Sample Request

curl -L -X GET 'https://api.appzen.com/expense-audit-results/v2/reports/APISampleReport1' \
-H 'Authorization: Bearer eyJrxxxx' \
-H 'Cookie: JSESSIONID=7D4120C01A02DBDC70E6785E4044B141'

Sample Response

Success

{
    "customer_id": 100439,
    "external_report_id": "APISampleReport1",
    "current_risk_level": "HIGH",
    "original_risk_level": "HIGH",
    "computed_risk_level": "HIGH",
    "audit_result_created_at": "2022-12-27 04:01:38.950",
    "header_level_risk_details": [
        {
            "rule_name": "Report Unauthorized Expenses",
            "current_risk_level": "LOW",
            "original_risk_level": "LOW",
            "computed_risk_level": "LOW",
            "risk_message": "No unauthorized items were detected in report.",
            "parameters": null
        },
        {
            "rule_name": "Daily meal limit check",
            "current_risk_level": "LOW",
            "original_risk_level": "LOW",
            "computed_risk_level": "LOW",
            "risk_message": "Meal expenses are within threshold",
            "parameters": null
        }
    ],
    "line_level_results": [
        {
            "external_exp_line_id": "352549433",
            "line_level_risk_details": [
                {
                    "rule_name": "Expense Age",
                    "current_risk_level": "MEDIUM",
                    "original_risk_level": "MEDIUM",
                    "computed_risk_level": "MEDIUM",
                    "risk_message": "The transaction date exceeds the expense age threshold but has low confidence.",
                    "parameters": null
                },
                {
                    "rule_name": "Weekend Expense",
                    "current_risk_level": "LOW",
                    "original_risk_level": "LOW",
                    "computed_risk_level": "LOW",
                    "risk_message": "This expense is incurred during weekend days but the expense type is not applicable to apply this rule.",
                    "parameters": null
                },
                {
                    "rule_name": "Amount Verification",
                    "current_risk_level": "HIGH",
                    "original_risk_level": "HIGH",
                    "computed_risk_level": "HIGH",
                    "risk_message": "Amount for this line is above threshold of 20",
                    "parameters": null
                },
                {
                    "rule_name": "Amount Verification By Expense Type",
                    "current_risk_level": "LOW",
                    "original_risk_level": "LOW",
                    "computed_risk_level": "LOW",
                    "risk_message": "No Configuration in Expense Type found.",
                    "parameters": null
                },
                {
                    "rule_name": "Non-Conforming Receipt",
                    "current_risk_level": "LOW",
                    "original_risk_level": "LOW",
                    "computed_risk_level": "LOW",
                    "risk_message": "No evidence of a non-conforming receipt was detected",
                    "parameters": null
                },
                {
                    "rule_name": "Receipt Verification",
                    "current_risk_level": "HIGH",
                    "original_risk_level": "HIGH",
                    "computed_risk_level": "HIGH",
                    "risk_message": "User entered expense type is verified. Amount (USD 1200.00) and date (01-AUG-20) could not be verified.",
                    "parameters": null
                },
                {
                    "rule_name": "Merchant Price Check",
                    "current_risk_level": "LOW",
                    "original_risk_level": "LOW",
                    "computed_risk_level": "LOW",
                    "risk_message": "Expense type is not in applicable categories for Price Audit.",
                    "parameters": null
                },
                {
                    "rule_name": "Unauthorized Expenses",
                    "current_risk_level": "HIGH",
                    "original_risk_level": "HIGH",
                    "computed_risk_level": "HIGH",
                    "risk_message": " Alcohol was/were detected on receipt.",
                    "parameters": null
                },
                {
                    "rule_name": "Duplicate Across Reports",
                    "current_risk_level": "MEDIUM",
                    "original_risk_level": "MEDIUM",
                    "computed_risk_level": "MEDIUM",
                    "risk_message": "Duplicate expense line was detected but the expense types of these lines were not added in audit configuration.",
                    "parameters": null
                },
                {
                    "rule_name": "Duplicate Within A Report",
                    "current_risk_level": "LOW",
                    "original_risk_level": "LOW",
                    "computed_risk_level": "LOW",
                    "risk_message": "No duplicate expense line was detected within the same report",
                    "parameters": null
                },
                {
                    "rule_name": "Itemization Verification",
                    "current_risk_level": "LOW",
                    "original_risk_level": "LOW",
                    "computed_risk_level": "LOW",
                    "risk_message": "N/A: Type of Receipt not Applicable",
                    "parameters": null
                },
                {
                    "rule_name": "Merchant Category Check",
                    "current_risk_level": "LOW",
                    "original_risk_level": "LOW",
                    "computed_risk_level": "LOW",
                    "risk_message": "Merchant was not detected as anything suspicious, could not find merchant info",
                    "parameters": null
                }
            ]
        }
    ]
}

Failure

The request fails if you enter an invalid token.

{
    "timestamp": "2023-01-02T10:23:00.843+00:00",
    "status": 401,
    "error": "Unauthorized",
    "message":"Invalid unsecured/JWS/JWE header: Invalid JSON: Unexpected token Ț�Y\b����ٓ�[ZЍ�՛\f�]�Ә\\N����N���Z at position 41.",
    "path": "/v2/exp-audit-results/reports/APISampleReport1"
}

Response Code

See Also

• Token Generation
• Fetch Audit Results for Expense Reports in Bulk