packages/api-specs/server-api-v2/src/publicApi

// This builds the mint.json file for the given environment
// and merges the mint.config.json file for that environment
// into the mint.json file.
const env = process.argv.slice(2)[0];

const environment = env ?? 'production';

const path = require('node:path');
const mintJson = require('../mint.json');

const config = require('../mint.config.json')[environment];
const { writeFileSync } = require('node:fs');

if (!config) {
  throw new Error(`No config found for environment ${environment}`);
}

writeFileSync(
  path.resolve(__dirname, '../mint.json'),
  JSON.stringify(deepMerge(mintJson, config), undefined, 2)
);

function deepMerge(a, b) {
  return Object.fromEntries(
    Object.entries(a).map(([key, value]) => {
      if (key in b) {
        if (
          typeof value === 'object' &&
          typeof b[key] === 'object' &&
          !!value &&
          !!b[key]
        ) {
          return [key, deepMerge(value, b[key])];
        }

        return [key, b[key]];
      }

      return [key, value];
    })
  );
}


// this script checks that the mint.json file is using
// the production URL

const productionConfig = require('../mint.config.json').production;
const mintJson = require('../mint.json');

const red = '\x1b[31m';
const reset = '\x1b[0m';

if (productionConfig.openapi !== mintJson.openapi) {
  console.log(
    `${red}mint.json is not using the production URL. Run yarn docs:build:prod${reset}`
  );
  process.exit(1);
}


Retrieve a single virtual account by its ID.


Get virtual account

Money

The amount of money to be diverted from the virtual account if the type of rule is flat_fee.

The frequency from the start date that the rule will be applied. E.g. a start date of November 26, 2024 with a frequency of "monthly"
will have the rule applied on December 26, 2024. If the frequency was "yearly", the rule would be applied again on November 26, 2025.


The date that the rule will begin to take effect.

The type of the commission rule. A type of flat_fee will take a flat fee from the virtual account and transfer it to the primary account
with the frequency of the collection defined as monthly or yearly.


The percentage of funds to divert from the virtual account to the primary account.

The type of the commission rule. A type of take_rate will take a percent of the virtual account's funds and divert them to
the primary account.


VirtualAccountCommissionDetails

The virtual account commission rule object

Describes details of the commission rule.

The ID of the virtual account the commission rule is applied to

VirtualAccountCommissionRule

The account ID of the Slash account the virtual account is associated with.

The account number of the virtual account.

The account type of the virtual account. Since virtual accounts and Slash accounts exist at the same hierarchy level,
an account type of 'primary' means it is the main Slash account, while an account type of 'default' means it is a virtual account
under the main account.


The date the virtual account was closed; will be null if account was never closed.

The routing number of the virtual account.

VirtualAccountModel

api key

bearer

VirtualAccount

Error

Slash

Use the Slash API to access your account, transactions, cards and more.

Getting Started

Changelog

Legal Entity

Account

Virtual Account

Balance

Card

Transaction

Spending Constraint

Slash Handle

Card Group

Webhook

Webhook Event

Card Group Utilization

Authorization Webhook

Authorization Request Event

Authorization Webhook Response

List all legal entities you have access to

List legal entities

List accounts

Get account

Retrieve a list of balances for an account. 
The balances are returned in an array, with each item representing a balance for that account.

For charge_card accounts, there will be two balances returned: "cash" and "credit".
For debit accounts, there will only be one balance returned: "debit".


List account balances

Use authorization webhooks to approve or decline card transactions in real-time.

Authorization Webhook Overview

Retrieve the authorization webhook configuration for an account.
This webhook is called during card authorization requests to allow external systems
to approve or reject transactions in real-time.


Get account authorization webhook

Create or update the authorization webhook configuration for an account. This will upsert the webhook configuration, creating it if it doesn't exist or updating it if it does. 

The secret for a webhook remains static after it is initially created. If you would like to retrieve the secret before sending requests,
create the authorization webhook in status 'inactive' first and then update it to 'active' after.


Set account authorization webhook

Partially update the authorization webhook configuration for an account.
Only the provided fields will be updated.


Partially update account authorization webhook

Retrieve a list of virtual accounts under an account.
The virtual accounts are returned in an array, with each item representing a virtual account under that account.

The primary account will also be returned as a virtual account, with an account type of 'primary' while actual subaccounts
under the primary account will have an account type of 'default'.


List virtual accounts

Create virtual account

Update virtual account

List transactions

Get transaction aggregations

Fetch details for a single transaction by ID

Get transaction

Get transaction fee details

Add or update a note for a transaction

Transfer money between Virtual Accounts or fund a Virtual Account from a Primary Account

Create virtual account transfer

Get Crypto offramp addresses

List your Slash handles

Send money to a slash handle

List cards

Fetch details for a single card by card ID

Retrieve card

Create card

Update card

Get card utilization

Apply a partial update to a card's spending constraint while preserving current properties applied. Properties set to "null" will be removed from the spending constraint.

Apply a partial update to a card's spending constraint

Fully replace a card's spending constraint.

Replace a card's spending constraint

List all card products

Retrieve the list of card groups that the user owns.

List card groups

Create card group

Fetch details for a single card group by card group ID

Get card group

Update card group

Apply a partial update to a card group's spending constraint while preserving current properties applied. Properties set to "null" will be removed from the spending constraint.

Overview

Entities

Legal Entity

Account

Account Authorization Webhooks

Virtual Account

Transaction

Transfer Money

Slash Pay

Card

Card Group

Merchant

Webhooks

Get virtual account

Authorizations

Path Parameters

Response