---
title: "List management operations"
method: GET
path: "/v1/management_operations"
tags: ["Management Operations"]
---

# List management operations

`GET /v1/management_operations`

List management operations

## Query parameters

- `category` 'MANAGEMENT_FEE' | 'MANAGEMENT_DISPUTE' | 'MANAGEMENT_REWARD' | 'MANAGEMENT_ADJUSTMENT' | 'MANAGEMENT_DISBURSEMENT'
- `financial_account_token` string, uuid
- `business_account_token` string, uuid
- `status` 'PENDING' | 'SETTLED' | 'DECLINED' | 'REVERSED' | 'CANCELED' | 'RETURNED'
- `begin` string, date-time
- `ending_before` string
- `end` string, date-time
- `page_size` integer
- `starting_after` string

## Response `200`

OK

- ManagementOperationTransactionsResponse
  - `data` ManagementOperationTransaction[], required
    - `status` 'PENDING' | 'SETTLED' | 'DECLINED' | 'REVERSED' | 'CANCELED' | 'RETURNED', required
    - `token` string, uuid, required — Unique identifier for the transaction
    - `created` string, date-time, required — ISO 8601 timestamp of when the transaction was created
    - `updated` string, date-time, required — ISO 8601 timestamp of when the transaction was last updated
    - `family` 'MANAGEMENT_OPERATION', required — MANAGEMENT_OPERATION - Management Operation Transaction
    - `result` 'APPROVED' | 'DECLINED', required
    - `category` 'MANAGEMENT_FEE' | 'MANAGEMENT_DISPUTE' | 'MANAGEMENT_REWARD' | 'MANAGEMENT_ADJUSTMENT' | 'MANAGEMENT_DISBURSEMENT', required
    - `settled_amount` integer, required
    - `pending_amount` integer, required
    - `currency` string, required
    - `events` ManagementOperationEvent[], required
      - `amount` integer, required
      - `type` 'LOSS_WRITE_OFF' | 'CASH_BACK' | 'CASH_BACK_REVERSAL' | 'CURRENCY_CONVERSION' | 'CURRENCY_CONVERSION_REVERSAL' | 'INTEREST' | 'INTEREST_REVERSAL' | 'LATE_PAYMENT' | 'LATE_PAYMENT_REVERSAL' | 'BILLING_ERROR' | 'BILLING_ERROR_REVERSAL' | 'PROVISIONAL_CREDIT' | 'PROVISIONAL_CREDIT_REVERSAL' | 'RETURNED_PAYMENT' | 'RETURNED_PAYMENT_REVERSAL' | 'DISPUTE_WON' | 'DISPUTE_WON_REVERSAL' | 'DISBURSE' | 'DISBURSE_REVERSAL' | 'ANNUAL' | 'ANNUAL_REVERSAL' | 'QUARTERLY' | 'QUARTERLY_REVERSAL' | 'MONTHLY' | 'MONTHLY_REVERSAL', required
      - `subtype` string, nullable
      - `result` 'APPROVED' | 'DECLINED', required
      - `detailed_results` DetailedResults[], required
      - `created` string, date-time, required
      - `token` string, uuid, required
      - `memo` string, required
      - `effective_date` string, date, required
    - `user_defined_id` string, nullable
    - `financial_account_token` string, uuid, required
    - `direction` 'CREDIT' | 'DEBIT', required
    - `transaction_series` TransactionSeries, required
      - `type` string, required
      - `related_transaction_token` string, uuid, nullable, required
      - `related_transaction_event_token` string, uuid, nullable, required
    - `external_resource` ExternalResource — External resource associated with the management operation
      - `external_resource_type` 'STATEMENT' | 'COLLECTION' | 'DISPUTE' | 'UNKNOWN', required — Type of external resource associated with the management operation
      - `external_resource_token` string, required — Token identifying the external resource
      - `external_resource_sub_token` string — Token identifying the external resource sub-resource
  - `has_more` boolean, required

## Other responses

- `400` — A parameter in the query given in the request does not match the valid queries for the endpoint.
- `401` — | | | |---|---| | User has not been authenticated | Invalid or missing API key | | API key is not active | The API key used is no longer active | | Could not find API key | The API key provided is not associated with any user | | Please provide API key in Authorization header | The Authorization header is not in the request | | Please provide API key in the form Authorization: [api-key] | The Authorization header is not formatted properly | | Insufficient privileges. Issuing API key required | Write access requires an Issuing API key. Reach out at [lithic.com/contact](https://lithic.com/contact) | | Insufficient privileges to create virtual cards. | Creating virtual cards requires an additional privilege | Reach out at [lithic.com/contact](https://lithic.com/contact) |
- `429` — Client has exceeded the number of allowed requests in a given time period. | | | |---|---| | Rate limited, too many requests per second | User has exceeded their per second rate limit | | Rate limited, reached daily limit | User has exceeded their daily rate limit | | Rate limited, too many keys tried | One IP has queried too many different API keys |

---

[API](https://skmtc.net/lithic-com/apis/lithic-developer-api.md) · [All operations](https://skmtc.net/lithic-com/apis/lithic-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lithic-com/lithic-developer-api/revisions/53ab5d4e2adb/schema)