> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Update account dispute

> Update the amount or status of a dispute on a credit account.

POST/credit/accounts/\{account\_token}/disputes/\{dispute\_token}/transitions

Update the amount or status of a dispute on a credit account.

## URL path parameters

| Fields | Description |
| - | - |
| account\_token string  Required | Unique identifier of the credit account from which to update a dispute. Send a `GET` request to `/credit/accounts` to retrieve existing credit account tokens. **Allowable Values:**  Existing account token |
| dispute\_token string  Required | Unique identifier of the dispute to update. Send a `GET` request to `/credit/accounts/{account_token}/disputes` to retrieve existing credit account tokens. **Allowable Values:**  Existing dispute token |

## Request body

| Fields | Description |
| - | - |
| amount decimal  Required | Updated amount of the dispute, based on the resolution. **Allowable Values:**  Format: 0.00 |
| status string  Required | Status of the dispute. - `ACTIVE` - The dispute is active and awaiting resolution. - `REVERSED` - The dispute has been reversed and is no longer active. - `AH_WON` - The account holder won the dispute. - `AH_LOST` - The account holder lost the dispute. **Allowable Values:**  `ACTIVE`, `REVERSED`, `AH_WON`, `AH_LOST`, `REFUNDED` |
| notes string  Optional | Additional information on the dispute update (for example, a reason for the dispute update). **Allowable Values:**  750 char max |
| token string  Optional | Unique identifier of the dispute update. **Allowable Values:**  36 char max |
| source\_created\_time datetime  Optional | Date and time when the dispute occurred. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| interest\_adjustments array of objects  Optional | List of interest adjustments and their effective times, if applicable. Note that this typically only applies for a cross-cycle activity, such as a dispute or payment. **Allowable Values:**  Valid array of one or more `interest_adjustments` objects |
| interest\_adjustments\[].**currency\_code** string  Required | Valid three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html). **Allowable Values:**  `USD` |
| interest\_adjustments\[].**effective\_date** datetime  Required | Date and time when the dispute interest charge originally happened, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| interest\_adjustments\[].**amount** decimal  Required | The fee amount. **Allowable Values:**  - `< 0 (Credit)` - The dispute is initiated.  - `> 0 (Debit)` - The dispute is lost. |

## Sample request body

```json JSON lines wrap theme={null}
{
  "amount": 500,
  "status": "AH_WON"
}
```

## Response body

| Fields | Description |
| - | - |
| amount decimal  Returned | Amount of the updated dispute, based on the resolution. **Allowable Values:**  Format: 0.00 |
| status string  Returned | Status of the dispute. - `ACTIVE` - The dispute is active and awaiting resolution. - `REVERSED` - The dispute has been reversed and is no longer active. - `AH_WON` - The account holder won the dispute. - `AH_LOST` - The account holder lost the dispute. **Allowable Values:**  `ACTIVE`, `REVERSED`, `AH_WON`, `AH_LOST`, `REFUNDED` |
| notes string  Conditionally returned | Additional information on the dispute update (for example, a reason for the dispute update). **Allowable Values:**  750 char max |
| account\_token string  Returned | Unique identifier of the credit account on which the dispute was updated. **Allowable Values:**  Existing account token |
| token string  Returned | Unique identifier of the dispute update. **Allowable Values:**  36 char max |
| created\_time datetime  Returned | Date and time when the dispute update was created on Marqeta's credit platform, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |

## Sample response body

```json JSON lines wrap theme={null}
{
  "amount": 500,
  "status": "AH_WON",
  "notes": "account holder evidence accepted",
  "account_token": "my_account_token_12",
  "token": "dispute_update_token1234",
  "created_time": "2023-07-01T00:27:09Z"
}
```


## Related topics

- [Credit Account Disputes Overview](https://www.marqeta.com/docs/core-api/credit-account-disputes.md)
- [About Credit Account Disputes](https://www.marqeta.com/docs/developer-guides/about-credit-account-disputes.md)
- [Update account](https://www.marqeta.com/docs/core-api/credit-accounts/update-account.md)
- [Update account holder group](https://www.marqeta.com/docs/core-api/account-holder-groups/update-account-holder-group.md)
- [About Credit Accounts](https://www.marqeta.com/docs/developer-guides/about-credit-accounts.md)