Nautilus: Pelagic Mollusc


    3.2.4 • Public • Published

    Node.js library for the API

    This library provides convenient access to the API from applications written in Node.js.


    Install the package with:

    npm install checkbook-api --save


    The package needs to be configured with your account's API Key and API Secret.

    🔑 The API credentials below are from the demo environment and you can use them to try the API.

    var CheckbookAPI = require('checkbook-api');
    var Checkbook = new CheckbookAPI({
        api_key: 'd6aa2703655f4ba2af2a56202961ca86',
        api_secret: 'dXbCgzYBMibj8ZwuQMd2NXr6rtvjZ8',
        env: 'demo'

    The env parameter is optional and can be omitted if the requests are made to the live environment.
    The possible values for this parameter are demo or sandbox and the API credentials need to be from the specified environment.

    You can get the API Key and API Secret values from the Settings page.

    API Key and API Secret


    If you wish to send requests on behalf of another user, this user will use OAuth in order to generate a key that may be used on their behalf. You can get more details on our OAuth documentation page.

    Once you obtain the bearer token for a user, you can use it to send API requests on its behalf:

    var CheckbookAPI = require('checkbook-api');
    var Checkbook = new CheckbookAPI({
        bearer: '3658db04db340ce57b35fde7a56f669be222d96e33219bf28409812d1ca364b5',
        env: 'demo'


    You can use the following code snippet to send a digital check:

        name: 'Widgets Inc.',
        recipient: '',
        description: 'Test Send Check',
        amount: 10.00
    }, function (error, response) {
        if (error) {
            console.log('Error:', error);
        } else {
            console.log('Response:', response);

    You can use the following code snippet to query the list of checks:

        page: 1,
        per_page: 10,
        status: 'UNPAID'
    }, function (error, response) {
        if (error) {
            console.log('Error:', error);
        } else {
            console.log('Response:', response);

    ⭐️ You can find more code samples here.

    Methods reference

    The Checkbook class has several endpoints and you can find below the methods each one provides.

    You can click on the 📖 icon to access the detailed API reference for each method.

    • Checkbook.checks

      • list(query, callback) 📖
      • get(check_id, callback) 📖
      • delete(check_id, callback) 📖
      • sendDigitalCheck(params, callback[, idempotencyKey]) 📖
      • sendPhysicalCheck(params, callback[, idempotencyKey]) 📖
      • sendDirectCheck(params, callback[, idempotencyKey])
      • sendMultipleChecksCSV(params, callback[, idempotencyKey])
    • Checkbook.invoices

      • list(query, callback) 📖
      • get(invoice_id, callback) 📖
      • delete(invoice_id, callback) 📖
      • sendInvoice(params, callback[, idempotencyKey]) 📖
      • payInvoice(params, callback[, idempotencyKey]) 📖
    • Checkbook.subscriptions

      • list(query, callback) 📖
      • get(subscription_id, callback) 📖
      • delete(subscription_id, callback) 📖
      • update(subscription_id, params, callback) 📖
      • sendRecurringCheck(params, callback[, idempotencyKey]) 📖
      • sendRecurringInvoice(params, callback[, idempotencyKey]) 📖
    • Checkbook.banks

      • list(callback) 📖
      • institutions(callback) 📖
      • delete(bank_id, callback) 📖
      • instantAccountVerification(params, callback[, idempotencyKey]) 📖
      • addBankAccount(params, callback[, idempotencyKey]) 📖
      • verifyMicrodesposits(params, callback) 📖
    • Checkbook.users

      • create(params, callback[, idempotencyKey]) 📖
      • update(params, callback) 📖
      • get(callback) 📖
      • list(query, callback) 📖
      • delete(user_id, callback) 📖
      • addSignature(params, callback) 📖

    💡 The query object used for the list(query, callback) methods can have the following attributes:

    • start_date : 'yyyy-mm-dd'
    • end_date : 'yyyy-mm-dd'
    • direction : 'INCOMING'|'OUTGOING'
    • q : 'search query'
    • per_page : 10|25|50
    • page : [1..N]

    Getting help

    If you need help installing or using the library, please contact Support at

    If you've instead found a bug in the library or would like new features added, please open issues or pull requests against this repo.

    More Information


    npm i checkbook-api

    DownloadsWeekly Downloads






    Unpacked Size

    150 kB

    Total Files


    Last publish


    • checkbook