---
title: "Creates a balance adjustment for the specified account.
Supports adjustment types such as promo, instructionCredit, disbursement, achOut, and their reversals."
method: POST
path: "/programs/{programCode}/accounts/{accountIdentifier}/adjustments"
tags: ["Adjustment"]
---

# Creates a balance adjustment for the specified account.
Supports adjustment types such as promo, instructionCredit, disbursement, achOut, and their reversals.

`POST /programs/{programCode}/accounts/{accountIdentifier}/adjustments`

The following adjustment types must be specifically configured for a program code in order to be used by a partner. 
- promo and promoReversal 
- instructionCredit and instructionDebit 
- disbursement, disbursementReversal 
- anyDebitOut, anyDebitOutReversal 
- achOut, achOutReversal 

 If an adjustmentType has not been configured for a program code, then the request will be rejected. 

 If you have any further questions, please contact your Green Dot Product liaisons. Request Parameters.

## Path parameters

- `programCode` string, required
- `accountIdentifier` string, required

## Headers

- `X-GD-MaxRetryDuration` string
- `X-GD-RequestId` string, required
- `X-GD-CallMode` string

## Request body

- AdjustBalanceRequest — Represents a request to create a balance adjustment for an account. Contains details such as adjustment identifier, amount, currency, adjustment type, description, fee, and debit-to-negative flag. Used to initiate credits, debits, or reversals on BaaS account balances.
  - `adjustmentIdentifier` string, nullable — The unique identifier for the adjustment request.
  - `amount` number, double — The amount to adjust (positive for credit, negative for debit).
  - `currency` string, nullable — The ISO 4217 currency code for the adjustment (e.g., "USD").
  - `adjustmentType` string, nullable — The type of adjustment (e.g., promo, disbursement, achOut, or their reversals).
  - `adjustmentDescription` string, nullable — A description for the adjustment, such as the reason or reference for the transaction.
  - `fee` number, double — The fee amount associated with the adjustment, if applicable.
  - `debitToNegative` boolean, nullable — Indicates whether the adjustment allows the account to go negative (debit-to-negative).

## Response `200`

OK

- AdjustBalanceResponse — Represents the response returned after processing a balance adjustment request. Contains the adjustment status, status reason, and adjustment identifier. Used to communicate the result of a credit, debit, or reversal operation on an account.
  - `adjustmentStatus` string, nullable — The status of the adjustment (e.g., "pending", "completed", "failed").
  - `adjustmentStatusReason` string, nullable — The reason for the current adjustment status, if applicable.
  - `adjustmentIdentifier` string, nullable — The unique identifier for the adjustment request.
  - `responseDetails` ResponseDetail[], nullable — Required: A list of response details providing status codes, descriptions, and additional information about the result of the operation.
    - `code` integer — The primary status or error code for the response (e.g., 200 for success, 400 for validation error).
    - `subCode` integer, nullable — An optional subcode providing more granular detail about the response or error.
    - `description` string, nullable — A human-readable description of the response, error, or status.
    - `url` string, nullable — A URL linking to documentation or a web page with more information about the response code.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/greendot/apis/baas-apis.md) · [All operations](https://skmtc.net/greendot/apis/baas-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/greendot/baas-apis/revisions/666553766b78/schema)