---
title: "RetrieveSettlement"
method: GET
path: "/v1/{location_id}/settlements/{settlement_id}"
tags: ["V1Transactions"]
---

# RetrieveSettlement

`GET /v1/{location_id}/settlements/{settlement_id}`

Provides comprehensive information for a single settlement.

The returned `Settlement` objects include an `entries` field that lists
the transactions that contribute to the settlement total. Most
settlement entries correspond to a payment payout, but settlement
entries are also generated for less common events, like refunds, manual
adjustments, or chargeback holds.

Square initiates its regular deposits as indicated in the
[Deposit Options with Square](https://squareup.com/help/us/en/article/3807)
help article. Details for a regular deposit are usually not available
from Connect API endpoints before 10 p.m. PST the same day.

Square does not know when an initiated settlement **completes**, only
whether it has failed. A completed settlement is typically reflected in
a bank account within 3 business days, but in exceptional cases it may
take longer.

## Path parameters

- `location_id` string, required
- `settlement_id` string, required

## Response `200`

Success

- V1Settlement — V1Settlement
  - `bank_account_id` string — The Square-issued unique identifier for the bank account associated with the settlement.
  - `entries` V1SettlementEntry[] — The entries included in this settlement.
    - `amount_money` V1Money
      - `amount` integer — Amount in the lowest denominated value of this Currency. E.g. in USD these are cents, in JPY they are Yen (which do not have a 'cent' concept).
      - `currency_code` string
    - `fee_money` V1Money
      - `amount` integer — Amount in the lowest denominated value of this Currency. E.g. in USD these are cents, in JPY they are Yen (which do not have a 'cent' concept).
      - `currency_code` string
    - `payment_id` string — The settlement's unique identifier.
    - `type` string — The settlement's current status.
  - `id` string — The settlement's unique identifier.
  - `initiated_at` string — The time when the settlement was submitted for deposit or withdrawal, in ISO 8601 format.
  - `status` string — The settlement's current status.
  - `total_money` V1Money
    - `amount` integer — Amount in the lowest denominated value of this Currency. E.g. in USD these are cents, in JPY they are Yen (which do not have a 'cent' concept).
    - `currency_code` string

---

[API](https://skmtc.net/square/apis/squareup.md) · [All operations](https://skmtc.net/square/apis/squareup/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/square/squareup/versions/8d95e3639487/schema)