---
title: "Request to send money"
method: POST
path: "/account/{accountId}/request-send-money"
tags: ["Accounts"]
---

# Request to send money

`POST /account/{accountId}/request-send-money`

Create a "request to send money" that will require approval based on your organization's approval policies.

## Path parameters

- `accountId` string, uuid, required — ID for a Mercury account.

## Request body

- SendMoneyAPIRequest
  - `amount` number, double, required — A positive dollar amount with at least 1 cent.
  - `externalMemo` string — Optional external memo
  - `idempotencyKey` string, required — Unique string identifying the transaction
  - `note` string — Optional note
  - `paymentMethod` 'ach' | 'check' | 'domesticWire' | 'internationalWire', required
  - `purpose` PostTransactionSendMoneyPurpose — External API representation of SendMoneyPurpose. Only exposes the 'simple' field to decouple internal implementation from external API.
    - `simple` SimplePurpose
      - `additionalInfo` string — Additional information. Required for: Vendor (vendor name), Contractor (contractor name), Other (payment description). Optional for Subsidiary (subsidiary name). Not accepted for any other categories.
      - `category` 'employee' | 'landlord' | 'vendor' | 'contractor' | 'subsidiary' | 'transferToMyExternalAccount' | 'familyMemberOrFriend' | 'forGoodsOrServices' | 'angelInvestment' | 'savingsOrInvestments' | 'expenses' | 'travel' | 'other', required — Payment category.
  - `recipientId` string, uuid, required — ID for a Mercury account.

## Response `200`

- SendMoneyApprovalRequestResponse — A pending or completed approval request for a Mercury payment.
  - `accountId` string, uuid, required — ID for a Mercury account.
  - `amount` number, double, required — A positive dollar amount with at least 1 cent.
  - `createdAt` string, yyyy-mm-ddThh:MM:ssZ, required — Time at which the payment request was created.
  - `memo` string, nullable
  - `numberOfApproversRequired` integer, nullable — Total number of approvals required for this payment to be sent. May be null for older requests where the requirement is not available.
  - `paymentMethod` 'ach' | 'check' | 'domesticWire' | 'internationalWire', required
  - `recipientId` string, uuid, required — ID for a Mercury account.
  - `requestId` string, required
  - `requestedByUserId` string, uuid, required — The user who created the payment request.
  - `reviews` PaymentApprovalReview[], required — Approval decisions recorded against this request, ordered from oldest to most recent.
    - `reviewedAt` string, yyyy-mm-ddThh:MM:ssZ, required
    - `reviewerUserId` string, uuid, required — ID for the user
    - `status` 'approved' | 'rejected', required
  - `scheduledSendDate` string, date, nullable — Date on which the payment is scheduled to be sent once fully approved. Null when the payment will be sent as soon as approvals are complete.
  - `status` 'pendingApproval' | 'approved' | 'rejected' | 'cancelled', required

## Other responses

- `400` — Invalid `body`
- `404` — `accountId` not found

---

[API](https://skmtc.net/mercurytechnologies/apis/mercury-api.md) · [All operations](https://skmtc.net/mercurytechnologies/apis/mercury-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mercurytechnologies/mercury-api/revisions/0bdf4a496e03/schema)