> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay-60c89f9a-mintlify-audit-missing-sections-1778528421.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch a Settlement

> Retrieves the details of a specific settlement using its unique identifier.



## OpenAPI

````yaml /openapi/core.json get /settlements/{id}
openapi: 3.1.0
info:
  title: Razorpay Core Resources API
  description: >-
    The Razorpay Core Resources API provides endpoints for managing Orders,
    Payments, Refunds, and Settlements. Use HTTP Basic Auth with your Key ID as
    the username and Key Secret as the password.
  version: 1.0.0
  contact:
    name: Razorpay Support
    url: https://razorpay.com/support
servers:
  - url: https://api.razorpay.com/v1
    description: Razorpay Production API
security:
  - basicAuth: []
tags:
  - name: Orders
    description: >-
      Orders represent payment intents. Create an order before accepting a
      payment from a customer.
  - name: Payments
    description: >-
      Payments represent individual payment transactions. Fetch, list, and
      capture payments.
  - name: Refunds
    description: >-
      Refunds represent the reversal of a payment back to the customer. Initiate
      full or partial refunds against captured payments.
  - name: Settlements
    description: >-
      Settlements represent the transfer of funds collected from payments to
      your registered bank account.
paths:
  /settlements/{id}:
    get:
      tags:
        - Settlements
      summary: Fetch a Settlement
      description: >-
        Retrieves the details of a specific settlement using its unique
        identifier.
      operationId: getSettlement
      parameters:
        - name: id
          in: path
          required: true
          description: The unique identifier of the settlement to retrieve.
          schema:
            type: string
            example: setlmnt_FQzNIarBr3mItW
      responses:
        '200':
          description: The settlement details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Settlement'
              example:
                id: setlmnt_FQzNIarBr3mItW
                entity: settlement
                amount: 1000000
                status: processed
                fees: 2000
                tax: 360
                utr: HDFC2104081234567
                created_at: 1595491308
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '404':
          $ref: '#/components/responses/NotFoundError'
components:
  schemas:
    Settlement:
      type: object
      description: >-
        A Razorpay Settlement object representing the transfer of funds to your
        bank account.
      properties:
        id:
          type: string
          description: Unique identifier for the settlement.
          example: setlmnt_FQzNIarBr3mItW
        entity:
          type: string
          description: Entity type, always `settlement` for settlement objects.
          example: settlement
        amount:
          type: integer
          description: >-
            The total amount settled to your bank account, in the smallest
            currency sub-unit (e.g., paise for INR).
          example: 1000000
        status:
          type: string
          description: The current status of the settlement.
          enum:
            - created
            - processed
            - failed
          example: processed
        fees:
          type: integer
          description: >-
            The total Razorpay fees charged for this settlement, in the smallest
            currency sub-unit.
          example: 2000
        tax:
          type: integer
          description: >-
            The tax amount (GST) charged on the Razorpay fees, in the smallest
            currency sub-unit.
          example: 360
        utr:
          type: string
          description: >-
            Unique Transaction Reference number assigned by the bank for this
            settlement transfer.
          example: HDFC2104081234567
        created_at:
          type: integer
          description: Unix timestamp (in seconds) at which the settlement was created.
          example: 1595491308
    ErrorResponse:
      type: object
      description: An error response returned by the API.
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: A machine-readable error code.
              example: BAD_REQUEST_ERROR
            description:
              type: string
              description: A human-readable description of the error.
              example: The amount must be at least 100 paise.
            source:
              type: string
              description: The source of the error (e.g., `business` or `customer`).
              example: business
            step:
              type: string
              description: The step at which the error occurred.
              example: payment_initiation
            reason:
              type: string
              description: A brief reason for the error.
              example: input_validation_failed
            metadata:
              type: object
              description: Additional metadata about the error.
              additionalProperties: true
  responses:
    UnauthorizedError:
      description: Authentication credentials are missing or invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFoundError:
      description: The requested resource was not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: Use your Razorpay Key ID as the username and Key Secret as the password.

````