Checks
Get check print details
Use the Checks API to retrieve the status and details of a submitted check print request.
By the end of this tutorial, you will
- Retrieve an accounts payable 6‑column check (U.S. or Canada) without special delivery.
- Retrieve an accounts payable check (U.S. or Canada) that has not yet been exported.
- Retrieve a U.S. cashier’s check with remittance documents and FedEx delivery.
- Retrieve an accounts payable check (U.S.) with an export failure.
Before you begin
To retrieve a check print status, you need the following:
- A registered and fully onboarded Developer Account on the J.P. Morgan Payments Developer Portal.
- An active project with API credentials to make requests.
- A valid check print ID returned from a prior
POST/checks/print request.
Retrieve check print details
Use the following request to retrieve the status of a previously submitted check print request
Send a GET request to /checks/prints/{id}. Replace {id} with the print ID returned from the POST /checks/print request.
Sample: Request
Json
{
"id": "a1b2c3d4-e5f6-7g8h-9i0j-k1l2m3n4o5p6"
}Status response scenarios
The request format is the same for all scenarios. The response varies based on how the request was configured and its processing status.
U.S. or Canada accounts payable 6‑column, standard delivery
The following response shows an account payable 6‑column check for the U.S. or Canada with standard delivery and no special handling.
Sample: Response
Json
{
"debtor": {
"accountNumber": "1234567"
},
"checkNumber": "100200301",
"checkType": "CUSTOMER_CHECK",
"issueDate": "2025-12-10",
"checkAmount": {
"amount": "1200.00",
"currency": "USD"
},
"id": "b1b2c3d4-e5f6-7g8h-9i0j-k1l2m3n4o5p6",
"formCode": "JULIETWO",
"printType": "ACCOUNTS_PAYABLE_6_COLUMN",
"checkPrintValidationStatus": "SUCCESS",
"checkApprovalStatus": "SUCCESS",
"checkPrintValidationErrors": [],
"exportStatus": true,
"vendorId": "SUPDEPOT01",
"delivery": {
"courier": "UPS",
"contactPhone": "312-555-6789"
},
"payees": [
{
"name": "Supply Depot Inc",
"priority": 1
}
],
"address": {
"addressLines": [
"789 Market St"
],
"city": "Chicago",
"postalCode": "60601",
"countrySubDivision": "IL",
"country": "US"
},
"remittance": {
"documents": [
{
"description": [
"Office Supplies October"
],
"documentDate": "2023-10-10",
"documentIdentifier": "INV-9001",
"amounts": [
{
"value": {
"amount": "1200.00",
"currency": "USD"
},
"type": "NET_AMOUNT"
},
{
"value": {
"amount": "0.00",
"currency": "USD"
},
"type": "DISCOUNT_AMOUNT"
},
{
"value": {
"amount": "1200.00",
"currency": "USD"
},
"type": "GROSS_AMOUNT"
}
]
}
]
},
"requestInvocationId": "n8a40v3r-3769-4o79-9z0l-ale1edc90389"
}U.S. or Canada accounts payable, not yet exported
The following response indicates that the account payable check print request is received but the checks are not exported for printing.
Sample: Response
Json
{
"debtor": {
"accountNumber": "1234567"
},
"checkNumber": "100200300",
"checkType": "CUSTOMER_CHECK",
"issueDate": "2025-12-09",
"checkAmount": {
"amount": "1000.00",
"currency": "USD"
},
"id": "c1b2c3d4-e5f6-7g8h-9i0j-k1l2m3n4o5p6",
"formCode": "123AP6",
"printType": "ACCOUNTS_PAYABLE_6_COLUMN",
"checkPrintValidationStatus": "SUCCESS",
"checkApprovalStatus": "SUCCESS",
"checkPrintValidationErrors": [],
"exportStatus": false,
"vendorId": "SUPDEPOT01",
"delivery": {
"courier": "UPS",
"contactPhone": "312-555-6789",
"specialHandling": {
"deliveryAddress": {
"addressLines": [
"Anon",
"PO Box 5678",
"123 Delivery Ave"
],
"city": "Chicago",
"postalCode": "60642",
"countrySubDivision": "IL",
"country": "US"
},
"companyName": "PO Box Services",
"attention": "Billing Dept"
}
},
"memoLines": [
"Payment for October supplies"
],
"payees": [
{
"name": "Jane Doe",
"priority": 1
}
],
"address": {
"addressLines": [
"789 Market St",
"Lon & Brooklyn",
"Suite 100"
],
"city": "Chicago",
"postalCode": "60601",
"countrySubDivision": "IL",
"country": "US"
},
"remittance": {
"documents": [
{
"description": [
"Payment for services rendered"
],
"documentDate": "2023-10-10",
"documentIdentifier": "INV-10001",
"amounts": [
{
"value": {
"amount": "1000.00",
"currency": "USD"
},
"type": "NET_AMOUNT"
},
{
"value": {
"amount": "0.00",
"currency": "USD"
},
"type": "DISCOUNT_AMOUNT"
},
{
"value": {
"amount": "1000.00",
"currency": "USD"
},
"type": "GROSS_AMOUNT"
}
]
}
]
},
"requestInvocationId": "n8a40v3r-3769-4o79-9z0l-ale1edc90389"
}U.S. cashier’s check with remittance and FedEx delivery
The following response indicates that the cashier's check is printed with remittance documents and delivered using an expedited courier such as FedEx.
Sample: Response
Json
{
"debtor": {
"accountNumber": "987654321"
},
"checkNumber": "1800",
"clientReference": "REF1234566",
"checkType": "CUSTOMER_CHECK",
"issueDate": "2024-07-30",
"checkAmount": {
"amount": "500.00",
"currency": "USD"
},
"id": "d1b2c3d4-e5f6-7g8h-9i0j-k1l2m3n4o5p6",
"formCode": "CASHIER",
"printType": "CASHIERS",
"checkPrintValidationStatus": "SUCCESS",
"checkApprovalStatus": "SUCCESS",
"checkPrintValidationErrors": [],
"exportStatus": true,
"vendorId": "12345",
"delivery": {
"courier": "FEDEX",
"contactPhone": "312-555-6789"
},
"payees": [
{
"name": "John Doe",
"priority": 1
},
{
"name": "ELITE CORP",
"priority": 2
}
],
"address": {
"addressLines": [
"456 Corporate Ave",
"Floor 10",
"Building B"
],
"city": "Chicago",
"postalCode": "60642",
"countrySubDivision": "IL",
"country": "US"
},
"remittance": {
"documents": [
{
"description": [
"Reimbursement",
"Back pay"
],
"documentDate": "2020-01-01",
"amounts": [
{
"value": {
"amount": "500.00",
"currency": "USD"
},
"type": "NET_AMOUNT"
}
]
}
],
"remitter": "Acme Corp"
},
"requestInvocationId": "n8a40v3r-3769-4o79-9z0l-ale1edc90389"
}U.S. accounts payable with export failure
The following response indicates that the request was submitted successfully but the export process failed.
Sample: Response
Json
{
"debtor": {
"accountNumber": "987654321"
},
"clientReference": "REF1234567",
"checkNumber": "32000",
"checkType": "CUSTOMER_CHECK",
"issueDate": "2024-07-30",
"checkAmount": {
"amount": "500.00",
"currency": "USD"
},
"id": "a1b2c3d4-e5f6-7g8h-9i0j-k1l2m3n4o5p6",
"printType": "CASHIERS",
"formCode": "CASHIER",
"checkApprovalStatus": "SUCCESS",
"checkPrintValidationStatus": "ERROR",
"checkPrintValidationErrors": [
"Error Inserting records"
],
"exportStatus": false,
"vendorId": "98765",
"delivery": {
"courier": "USPS",
"contactPhone": "212-555-1234"
},
"payees": [
{
"name": "Jack Doe",
"priority": 1
}
],
"address": {
"addressLines": [
"123 Main St"
],
"city": "New York",
"postalCode": "10001",
"countrySubDivision": "NY",
"country": "US"
},
"remittance": {
"remitter": "ABC Corporation"
},
"requestInvocationId": "n8a40v3r-3769-4o79-9z0l-ale1edc90389"
}Related
- For more information about check print, see check print overview.
- For more information about status responses and error codes supported by the Checks API, see Error Codes.
- For more information about check print resources, see Resources.