Denying checks

In ClaimCenter, the ability to deny checks is a safeguard that helps ensure that only valid, accurate, and compliant payments are made. You can use the Cloud API to deny a check when the check still has a "Requesting" or "Notifying" status. This endpoint provides a way to not only manually deny checks but also implement automated denial workflows.

Use the following endpoint to deny a check when the check still has a "Requesting" or "Notifying" status:

  • POST /claims/{claimId}/checks/{checkId}/deny

Request

POST /claims/demo_sample:dc/checks/xc:123/deny

This request can have no body.

This example denies the check xc:123. When the request is successful, the API returns the check information, along with its denied status.

Response

{
    "data": {
        "attributes": {
            "checkBatching": {
                "code": "apdefault",
                "name": "A/P default"
            },
            "checkType": {
                "code": "primary",
                "name": "Primary"
            },
            "enteredTime": "2025-10-01T20:59:20.972Z",
            "grossAmount": {
                "amount": "50.00",
                "currency": "usd"
            },
            "id": "xc:123",
            "memo": "Claim 123-45-678901",
            "payees": [
                {
                    "contact": {
                        "displayName": "Albert Albertson",
                        "id": "xc:987",
                        "type": "ClaimContact",
                        "uri": "/claim/v1/claims/demo_sample:1/contacts/xc:987"
                    },
                    "id": "xc:456",
                    "payeeType": {
                        "code": "insured",
                        "name": "Insured"
                    }
                }
            ],
            "paymentMethod": {
                "code": "eft",
                "name": "Electronic funds transfer"
            },
            "payments": [
                {
                    "displayName": "(1) 1st Party Vehicle - Albert Albertson; Claim Cost/Auto body; USD; Denied",
                    "id": "xc:135",
                    "type": "Payment",
                    "uri": "/claim/v1/claims/demo_sample:1/payments/xc:135"
                }
            ],
            "reportability": {
                "code": "notreportable",
                "name": "Not reportable"
            },
            "reportableAmount": {
                "amount": "50.00",
                "currency": "usd"
            },
            "scheduledSendDate": "2025-10-01",
            "scheduledSendDateTime": "2025-10-01T00:00:00.000Z",
            "status": {
                "code": "denied",
                "name": "Denied"
            }
        }
    }
}