# List Balance Adjustments Retrieve a list of resources for an . Only or credentials can be used to retrieve objects. For details on how to query endpoints using the available parameters, see Query Parameters. Endpoint: GET /balance_adjustments Version: 2022-02-01 Security: BasicAuth ## Header parameters: - `Finix-Version` (string) Specify the API version of your request. For more details, see Versioning. Example: "2022-02-01" ## Query parameters: - `limit` (integer) The numbers of items to return. Example: 3 - `after_cursor` (string) Return every resource created after the cursor value. - `before_cursor` (string) Return every resource created before the cursor value. ## Response 200 fields (application/json): - `_embedded` (object) List of objects. - `_embedded.balance_adjustments` (array) objects. - `_embedded.balance_adjustments.id` (string) The ID of the resource. - `_embedded.balance_adjustments.created_at` (string) Timestamp of when the object was created. - `_embedded.balance_adjustments.updated_at` (string) Timestamp of when the object was last updated. - `_embedded.balance_adjustments.amount` (integer) The total amount that will be debited in cents (e.g. 100 cents to debit $1.00). - `_embedded.balance_adjustments.balance_entry_id` (string) A ledger record that tracks individual financial movements within a . - `_embedded.balance_adjustments.currency` (string) ISO 4217 3 letter currency code. Enum: "USD" - `_embedded.balance_adjustments.description` (string) A description of the . - `_embedded.balance_adjustments.failure_code` (string,null) The code of the failure so the decline can be handled programmatically. For more info on how to handle the failure, see [Failure Codes](/guides/payouts/handling-payout-failures). - `_embedded.balance_adjustments.failure_message` (string,null) The code of the failure so the decline can be handled programmatically. For more info on how to handle the failure, see [Failure Codes](/guides/payouts/handling-payout-failures). - `_embedded.balance_adjustments.instrument_id` (string) The account, card, or bank account that is credited or debited as part of the adjustment. - `_embedded.balance_adjustments.processor` (string) The payment processing entity responsible for handling transactions, fund movements, etc., between different financial accounts. Enum: "DUMMY_V1", "FINIX_V1" - `_embedded.balance_adjustments.rail` (string) The method of adjustment. Enum: "ACH" - `_embedded.balance_adjustments.state` (string) The status of the balance adjustment, indicating whether the adjustment was successful or failed. - - The balance adjustment has been initiated but is not yet confirmed. - - The adjustment was successful, and the funds are available. This typically occurs 1-3 business days after . - - Finix was unable to process the adjustment, and the balance was not updated. - - The adjustment was initially successful, but a subsequent return resulted in a reversal of the balance increase. Enum: "FAILED", "RETURNED", "SUBMITTED", "SUCCEEDED" - `_embedded.balance_adjustments.trace_id` (string) A unique identifier for tracking the across its lifecycle. - `_embedded.balance_adjustments.type` (string) Specifies whether the increases or decreases the account balance. - - Adds funds to the balance (e.g., a deposit or manual funding). Enum: "TOP_UP" - `_embedded.balance_adjustments.tags` (object,null) Include up to 50 pairs to annotate requests with custom metadata. - Maximum character length for individual is 40. - Maximum character length for individual is 500. (For example, , , ) - `_embedded.balance_adjustments._links` (object) An object containing link(s) relevant to the request. You can store these links for follow-up requests. - `_embedded.balance_adjustments._links.self` (object) - `_embedded.balance_adjustments._links.self.href` (string) The path to the new resource. - `_links` (object) For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these to make your follow-up requests and quickly access relevant IDs. - `_links.next` (object) Link to the next page of entries. - `_links.next.href` (string) - `_links.self` (object) Link to the resource that was used in the request. - `page` (object) Details the page that's returned. - `page.limit` (integer) The number of entries to return. - `page.next_cursor` (string,null) The cursor to use for the next page of results. ## Response 401 fields (application/json): - `total` (integer) - `_embedded` (object) - `_embedded.errors` (array) - `_embedded.errors.code` (string) Enum: "UNKNOWN" - `_embedded.errors.logref` (object) - `_embedded.errors.message` (string) - `_embedded.errors._links` (object) - `_embedded.errors._links.self` (object) - `_embedded.errors._links.self.href` (string) - `_embedded.errors._links.source` (object) ## Response 403 fields (application/json): - `total` (integer) - `_embedded` (object) - `_embedded.errors` (array) - `_embedded.errors.code` (string) Enum: "FORBIDDEN" - `_embedded.errors.logref` (object) - `_embedded.errors.message` (string) - `_embedded.errors._links` (object) - `_embedded.errors._links.source` (object) - `_embedded.errors._links.source.href` (string) ## Response 404 fields (application/json): - `total` (integer) - `_embedded` (object) - `_embedded.errors` (array) - `_embedded.errors.code` (string) Enum: "NOT_FOUND" - `_embedded.errors.logref` (object) - `_embedded.errors.message` (string) - `_embedded.errors._links` (object) - `_embedded.errors._links.source` (object) - `_embedded.errors._links.source.href` (string) ## Response 422 fields (application/json): - `total` (integer) - `_embedded` (object) - `_embedded.errors` (array) - `_embedded.errors.code` (string) Enum: "INVALID_FIELD" - `_embedded.errors.field` (string) - `_embedded.errors.logref` (object) - `_embedded.errors.message` (string) - `_embedded.errors._links` (object) - `_embedded.errors._links.source` (object) - `_embedded.errors._links.source.href` (string)