GET web_api/private_bad_checks

Get your API user's complete Private Bad Checks list

Request Information

URI Parameters

None.

Body Parameters

None.

Response Information

Resource Description

A list containing all Private Bad Checks list items for your API user

Collection of PrivateBadCheck
NameDescriptionTypeAdditional information
BadCheckID

The unique identifier for the Private Bad Check list item

integer

None.

RoutingNumber

The Routing/ABA number of the bank account

string

Required

Matching regular expression pattern: ^[0-9]{9}$

AccountNumber

The individual account number of the bank account

string

Required

Matching regular expression pattern: ^[0-9]{4,17}$

Active

The current active/inactive status of the item. Items that are active will cause a value of GP01 to be returned for the AccountResponseCode for any inquiries on the bank account. To stop this, set the item's active property to false.

boolean

None.

CheckRejectReason

The reason that you listed for wanting to not accept items from this bank account

string

Required

Max length: 200

AddedDate

The DateTime that this Private Bad Checks item was added to your list

date

None.

LastUpdatedDate

The most recent date this item was updated

date

None.

LastActiveChanged

The most recent date this item's Active property was changed

date

None.

NameOnCheck

The name associated with this bank account on your records

string

Required

Max length: 50

CheckNumber

The check number for the item that caused you to add this bank account to you Private Bad Checks list

integer

Matching regular expression pattern: ^[0-9]{4,15}$

PhoneNumber

The phone number associated with this bank account on your records

string

Matching regular expression pattern: ^[0-9]{10}$

Response Formats

application/json, text/json

Sample:
[
  {
    "BadCheckID": 1,
    "RoutingNumber": "sample string 2",
    "AccountNumber": "sample string 3",
    "Active": true,
    "CheckRejectReason": "sample string 5",
    "AddedDate": "2025-04-28T07:34:06.1483031-05:00",
    "LastUpdatedDate": "2025-04-28T07:34:06.1483031-05:00",
    "LastActiveChanged": "2025-04-28T07:34:06.1483031-05:00",
    "NameOnCheck": "sample string 7",
    "CheckNumber": 1,
    "PhoneNumber": "sample string 8"
  },
  {
    "BadCheckID": 1,
    "RoutingNumber": "sample string 2",
    "AccountNumber": "sample string 3",
    "Active": true,
    "CheckRejectReason": "sample string 5",
    "AddedDate": "2025-04-28T07:34:06.1483031-05:00",
    "LastUpdatedDate": "2025-04-28T07:34:06.1483031-05:00",
    "LastActiveChanged": "2025-04-28T07:34:06.1483031-05:00",
    "NameOnCheck": "sample string 7",
    "CheckNumber": 1,
    "PhoneNumber": "sample string 8"
  }
]

application/xml, text/xml

Sample:
<ArrayOfPrivateBadCheck xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.giact.com/verificationservices/v5">
  <PrivateBadCheck>
    <AccountNumber>sample string 3</AccountNumber>
    <Active>true</Active>
    <AddedDate>2025-04-28T07:34:06.1483031-05:00</AddedDate>
    <BadCheckID>1</BadCheckID>
    <CheckNumber>1</CheckNumber>
    <CheckRejectReason>sample string 5</CheckRejectReason>
    <LastActiveChanged>2025-04-28T07:34:06.1483031-05:00</LastActiveChanged>
    <LastUpdatedDate>2025-04-28T07:34:06.1483031-05:00</LastUpdatedDate>
    <NameOnCheck>sample string 7</NameOnCheck>
    <PhoneNumber>sample string 8</PhoneNumber>
    <RoutingNumber>sample string 2</RoutingNumber>
  </PrivateBadCheck>
  <PrivateBadCheck>
    <AccountNumber>sample string 3</AccountNumber>
    <Active>true</Active>
    <AddedDate>2025-04-28T07:34:06.1483031-05:00</AddedDate>
    <BadCheckID>1</BadCheckID>
    <CheckNumber>1</CheckNumber>
    <CheckRejectReason>sample string 5</CheckRejectReason>
    <LastActiveChanged>2025-04-28T07:34:06.1483031-05:00</LastActiveChanged>
    <LastUpdatedDate>2025-04-28T07:34:06.1483031-05:00</LastUpdatedDate>
    <NameOnCheck>sample string 7</NameOnCheck>
    <PhoneNumber>sample string 8</PhoneNumber>
    <RoutingNumber>sample string 2</RoutingNumber>
  </PrivateBadCheck>
</ArrayOfPrivateBadCheck>