> ## Documentation Index
> Fetch the complete documentation index at: https://doc-test-my.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch Settlements With ID

> Fetch Settlements with Razorpay Settlements id.

Use this endpoint to retrieve details of a settlement with its id.

<RequestExample>
  ```bash Curl theme={null}
  curl -u <YOUR_KEY>:<YOUR_SECRET>\
  - X GET \
  https://api.razorpay.com/v1/settlements/setl_DGlQ1Rj8os78Ec
  ```

  ```java Java theme={null}
  RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");

  String settlementId = "setl_DGlQ1Rj8os78Ec";

  Settlement settlement = razorpay.settlement.fetch(settlementId);
  ```

  ```python Python theme={null}
  import razorpay
  client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET"))
  The following endpoint retrieves the
  client.settlement.fetch(settlementId)
  ```

  ```php PHP theme={null}
  $api = new Api($key_id, $secret);

  $api->settlement->fetch($settlementId);
  ```

  ```javascript Node.js theme={null}
  var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' })

  instance.settlements.fetch(settlementId)
  ```

  ```ruby Ruby theme={null}
  require "razorpay"
  Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET')

  settlementId = "setl_DGlQ1Rj8os78Ec"

  Razorpay::Settlement.fetch(settlementId)
  ```

  ```go Go theme={null}
  import ( razorpay "github.com/razorpay/razorpay-go" )
  client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET")

  body, err := client.Settlement.Fetch("<settlementId>", nil, nil)
  ```

  ```csharp .NET theme={null}
  RazorpayClient client = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");

  string settlementId = "setl_Z6t7VFTb9xXXXX";

  Settlement settlement = client.Settlement.Fetch(settlementId);
  ```

  ```bash CLI theme={null}
  razorpay settlements fetch setl_ABC123
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
      "id": "setl_DGlQ1Rj8os78Ec",
      "entity": "settlement",
      "amount": 9973635,
      "status": "processed",
      "fees": 0,
      "tax": 0,
      "utr": "1568176960vxp0rj",
      "created_at": 1568176960
  }
  ```

  ```json Failure theme={null}
  {
      "error": {
          "code": "BAD_REQUEST_ERROR",
          "description": "The api key provided is invalid",
          "source": "NA",
          "step": "NA",
          "reason": "NA",
          "metadata": {}
      }
  }
  ```
</ResponseExample>

## Path Parameters

<ParamField path="id" type="string" required>
  The unique identifier of the settlement to be retrieved.
</ParamField>

## Response Parameters

<ResponseField name="id" type="string">
  The unique identifier of the settlement transaction. For example, `setl_7IZKKI4Pnt2kEe`
</ResponseField>

<ResponseField name="entity" type="string">
  Indicates the type of entity. Here, it is `settlement`.
</ResponseField>

<ResponseField name="amount" type="integer">
  The amount to be settled (in the smallest unit of currency). For example, ₹500 will be `50000`.
</ResponseField>

<ResponseField name="status" type="string">
  Indicates the [settlement states](/docs/payments/settlements#settlement-states). Possible values:

  * `created`
  * `processed`
  * `failed`
</ResponseField>

<ResponseField name="fees" type="integer">
  This is the total fee charged for processing all payments received from customers settled to you in this settlement transaction. In case of a normal settlement, the fee charge will be `0`.
</ResponseField>

<ResponseField name="tax" type="integer">
  The total tax, in currency subunits, charged on the fees collected to process all payments received from customers settled to you in this settlement transaction. In case of a normal settlement, the tax charge will be `0`.
</ResponseField>

<ResponseField name="utr" type="string">
  The Unique Transaction Reference (UTR) number available across banks, which can be used to track a particular settlement in your bank account. For example, `1597813219e1pq6w`.
</ResponseField>

<ResponseField name="created_at" type="integer">
  Unix timestamp at which the settlement transaction was created.
</ResponseField>

## Errors

<AccordionGroup>
  <Accordion title="The API {key/secret} provided is invalid.">
    **Code:** `4xx`

    The API credentials passed in the API call differ from the ones generated on the Dashboard.

    **Solution:** The API keys must be active and entered correctly with no whitespace before or after.
  </Accordion>

  <Accordion title="The id provided does not exist.">
    **Code:** `400`

    The settlement id does not belong to the requestor or does not exist.

    **Solution:** Use a valid settlement id that belongs to the requestor.
  </Accordion>
</AccordionGroup>