Retrieve Payable Details and Status

This guide explains how to use the Payable API to retrieve the status and details of a specific payable. Users can track the status of their payables to get timely updates. Additionally, this API call is useful for displaying the full details of payables in external applications, making it easier for users to access and view their payment information.

Step 1: Prepare the request

  • Endpoint: /Payables/{recordNumber} Replace {recordNumber} with the unique identified of the payable you with to retrieve

  • Method: GET

Step 2: Send the GET request

Using your preferred method (command line, Postman, or a script), send the GET request to the endpoint.

Step 3: Handle the Response 

If your API call is successful, the API will respond with "200 OK" status code. This response will contain all the details associated with the payable, including it's status.

Possible statuses include:

  • Unprocessed

  • In Process

  • Paid

  • Failed

  • Scheduled

  • Canceled

If the recordNumber does not exist, the API will respond with a "404 Not Found" status code, indicating that the payable was not found in the system.

Example response: 

{
    "recordNumber": 2719,
    "payableReferenceId": "a9e6fb02-04e7-4d09-9dba-4bc847ac0e37",
    "originationISOCurrencyCode": "USD",
    "destinationISOCurrencyCode": "USD",
    "netTotal": 500.0000,
    "terms": "NET30",
    "dueDate": "2023-09-22T00:00:00+00:00",
    "effectiveDate": "2023-08-22T00:00:00+00:00",
    "approvalStatusId": 2,
    "memo": "Payment covers damages sustained by vehicle (Toyota Camry, 2020, 1339MN) during the storm incident on August 18, 2023. It also covers rental fees for a vehicle during car's repair period).",
    "grossTotal": 500.0000,
    "grossDiscount": 1.0000,
    "tax": 100.2500,
    "originationAccountReferenceId": "df1d4c29-8dfd-430e-aab8-487902d2cc5e",
    "destinationBankAccount_NameOnAccount": null,
    "destinationPaypal_AccessId": null,
    "destinationPaypal_AccessIdType": "0",
    "destinationCard_CardholderName": null,
    "destinationCard_ExpirationDate": null,
    "methodOfPaymentId": 5,
    "createdOn": "2023-09-25T08:20:26.627383-04:00",
    "payableStatusId": 3,
    "status": "Paid"
}