Authentication

Every Moov API request requires a valid OAuth token. Our authentication flow follows the OAuth 2.0 standard. When making requests from the browser, you’ll also need to request scope enums when generating a token. If a scope enum is required, it will be listed with the example.

GenerateToken

Generates an OAuth token required by Moov API requests. For more on our authentication protocol, read our quick start guide.

1
moov.generateToken(scopes, accountID)

Parameters

Name Type Description
scopes Array.<SCOPES> One or more permissions to request
accountID string Account on which to request permissions, default is your account ID

Returns

Promise.<Token>

You only need call this function when generating tokens for Moov.js and Moov Drops. The other functions in this library generate tokens for you automatically.

Examples

1
2
3
4
5
const moov = new Moov(...);
const token = await moov.generateToken([
  SCOPES.ACCOUNTS_CREATE,
  SCOPES.PING
]);

Ping

Pings the Moov servers to check for connectivity. Read more about /ping.

1
moov.ping()

Examples

1
2
3
4
5
6
7
const moov = new Moov(...);
try {
  await moov.ping();
  // Ping succeeded
} catch (err) {
  // Ping failed
}

Types

Token

OAuth2 token returned by Moov.generateToken(). Use Token.token in Moov.js and client-side code to make calls to the Moov API.

Properties

Property Type Description
token string String token required by Moov API requests
expiresOn Date Date and time when the token expires
refreshToken string String used to refresh this token

Enums

SCOPES

For client-side integration, you’ll need to request scopes when generating an OAuth token. See available scopes below:

Value Description
ACCOUNTS_CREATE Allows a new Moov account to be created
ACCOUNTS_READ List connected accounts – see also PROFILE_READ
BANK_ACCOUNTS_READ Access to view a linked bank account to a Moov account
BANK_ACCOUNTS_WRITE Access to add a linked bank account to a Moov account
CARDS_READ Access to view a linked card on a Moov account
CARDS_WRITE Access add a linked card to a Moov account
CAPABILITIES_READ Access to view capabilities, determining what actions the account can do
CAPABILITIES_WRITE Access to request capabilities, determining what actions the account can do
DOCUMENTS_READ Access to view documents (like I-9s, W-4s) associated with a Moov account
DOCUMENTS_WRITE Access to upload documents (like I-9s, W-4s) associated with a Moov account
PAYMENT_METHODS_READ Access to view payment methods for the account specified
PROFILE_ENRICHMENT_READ Access to view a Moov account’s profile image
PROFILE_READ Access to view details associated with a Moov account – see also ACCOUNTS_READ
PROFILE_WRITE Access to edit details associated with a Moov account
REPRESENTATIVE_READ Access to view details on business representatives for a Moov account
REPRESENTATIVE_WRITE Access to add details on business representatives for a Moov account
TRANSFERS_READ Access to view transfers
TRANSFERS_WRITE Access to move money by creating transfers
WALLETS_READ Access to view the balance on an account’s Moov wallet
FED_READ Allows a developer to use the institutions lookup service to look up a bank name by routing number
PING Ping Moov servers to test for connectivity
Summary Beta