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

# Retrieve a settlement

> Retrieve a settlement



## OpenAPI

````yaml get /settlements/{id}
openapi: 3.0.0
info:
  title: Flutterwave v3
  description: >-
    The Flutterwave for Business(F4B) APIs collection for all v3 endpoints with
    pre-formatted requests and response examples.
  contact: {}
  version: '1.0'
servers:
  - url: https://api.flutterwave.com/v3
    variables: {}
security:
  - bearer: []
tags:
  - name: Charges
    description: >-
      The charge APIs includes several payment collection methods to help you
      collect payments.
  - name: Tokenized Charges
    description: Tokenize your customers' cards with Flutterwave for faster payments
  - name: Preauthorization
    description: Manage preauth attemps on card transactions
  - name: Transactions
    description: Manage transactions, query statuses, logs and fees
  - name: Transfers
    description: Transfers to local and international customers
  - name: Beneficiaries
    description: Manage transfer beneficiaries
  - name: Virtual Cards
    description: Manage Flutterwave virtual cards
  - name: Virtual Account Numbers
    description: Manage virtual accounts
  - name: Collection Subaccounts
    description: Manage Collection Subaccounts
  - name: Payout Subaccounts
    description: Manage Payout Subaccounts
  - name: Subscriptions
    description: Manage user subscriptions
  - name: Payment Plans
    description: Manage Payment Plans
  - name: Bill Payments
    description: Manage Bill Payments
  - name: Banks
    description: Fetch Bank Information
  - name: Misc
    description: >-
      Verify user information like bank verification numbers, card bins, account
      information
  - name: Settlements
    description: Manage your settlements
  - name: Otps
    description: Create and manage one time passwords (OTPs) for your applications
  - name: Chargebacks
    description: Manage Chargebacks
paths:
  /settlements/{id}:
    get:
      tags:
        - Settlements
      summary: Get a Settlement
      description: Fetch single settlement details
      operationId: GetaSettlement
      parameters:
        - name: id
          in: path
          description: ''
          required: true
          style: simple
          schema:
            type: string
      responses:
        '200':
          description: OK
          headers:
            X-Powered-By:
              content:
                text/plain:
                  schema:
                    type: string
                  example: Express
            Access-Control-Allow-Origin:
              content:
                text/plain:
                  schema:
                    type: string
                  example: '*'
            Access-Control-Allow-Headers:
              content:
                text/plain:
                  schema:
                    type: string
                  example: >-
                    Origin, X-Requested-With, Content-Type, Accept,
                    Authorization, v3-xapp-id, flw-auth-token, mra-auth-token,
                    alt_mode_auth
            Access-Control-Allow-Methods:
              content:
                text/plain:
                  schema:
                    type: string
                  example: PUT, POST, GET, DELETE, OPTIONS
            Content-Length:
              content:
                text/plain:
                  schema:
                    type: string
                  example: '2858'
            ETag:
              content:
                text/plain:
                  schema:
                    type: string
                  example: W/"b2a-NsQxffVxRx36jjT/8GPQ7w"
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                  example: Mon, 20 Jan 2020 17:33:53 GMT
            Connection:
              content:
                text/plain:
                  schema:
                    type: string
                  example: keep-alive
          content:
            application/json; charset=utf-8:
              schema:
                allOf:
                  - $ref: '#/components/schemas/SampleSuccessResponse36'
                  - example:
                      status: success
                      message: Settlement fetched
                      data:
                        id: 41497
                        account_id: 73362
                        merchant_name: Earth Gang
                        merchant_email: selma.m0ckaham@flutterwavego.com
                        settlement_account: '0031318432'
                        bank_code: '063'
                        transaction_date: '2019-12-30T04:00:00.000Z'
                        due_date: '2019-12-30T04:00:00.000Z'
                        processed_date: null
                        status: completed
                        is_local: 1
                        currency: NGN
                        gross_amount: 50800
                        app_fee: 950
                        merchant_fee: 0
                        chargeback: 0
                        refund: 0
                        stampduty_charge: 0
                        net_amount: 49850
                        transaction_count: 5
                        processor_ref: null
                        disburse_ref: RV3E18675549F6A0
                        disburse_message: null
                        channel: web
                        destination: autowallet
                        fx_data: null
                        flag_message: null
                        meta: '[906256,906358,906301,906362,906319]'
                        refund_meta: null
                        chargeback_meta: null
                        source_bankcode: null
                        created_at: '2019-12-31T01:30:00.000Z'
                        transactions:
                          - customer_email: h0vkard@flw.ext
                            flw_ref: FLW-MOCK-RECURR-42b3daee9f470127dacd19560533f3a6
                            tx_ref: Rave-Pages017117571060
                            id: 984411
                            charged_amount: 10140
                            app_fee: 190
                            merchant_fee: 0
                            stampduty_charge: 0
                            settlement_amount: 9950
                            status: successful
                            payment_entity: card
                            transaction_date: '2019-12-30'
                            currency: NGN
                            card_locale: LOCAL
                            rrn: N/A
                            subaccount_settlement: 0
                          - customer_email: h0vkard@flw.ext
                            flw_ref: FLW-MOCK-RECURR-c536481525f02f76409892f517a16300
                            tx_ref: Rave-Pages017117571060
                            id: 984456
                            charged_amount: 10140
                            app_fee: 190
                            merchant_fee: 0
                            stampduty_charge: 0
                            settlement_amount: 9950
                            status: successful
                            payment_entity: card
                            transaction_date: '2019-12-30'
                            currency: NGN
                            card_locale: LOCAL
                            rrn: N/A
                            subaccount_settlement: 0
                          - customer_email: h0vkard@flw.ext
                            flw_ref: FLW-MOCK-RECURR-d22d0ec0955047e9648bec46da40c987
                            tx_ref: Rave-Pages017117571060
                            id: 984474
                            charged_amount: 10190
                            app_fee: 190
                            merchant_fee: 0
                            stampduty_charge: 0
                            settlement_amount: 10000
                            status: successful
                            payment_entity: card
                            transaction_date: '2019-12-30'
                            currency: NGN
                            card_locale: LOCAL
                            rrn: N/A
                            subaccount_settlement: 0
                          - customer_email: h0vkard@flw.ext
                            flw_ref: FLW-MOCK-RECURR-e55f863f14a95816e0939e7c4625ee43
                            tx_ref: Rave-Pages017117571060
                            id: 984513
                            charged_amount: 10190
                            app_fee: 190
                            merchant_fee: 0
                            stampduty_charge: 0
                            settlement_amount: 10000
                            status: successful
                            payment_entity: card
                            transaction_date: '2019-12-30'
                            currency: NGN
                            card_locale: LOCAL
                            rrn: N/A
                            subaccount_settlement: 0
                          - customer_email: h0vkard@flw.ext
                            flw_ref: FLW-MOCK-RECURR-6100e5300876cef2270b2e31bc9cc16e
                            tx_ref: Rave-Pages017117571060
                            id: 984517
                            charged_amount: 10140
                            app_fee: 190
                            merchant_fee: 0
                            stampduty_charge: 0
                            settlement_amount: 9950
                            status: successful
                            payment_entity: card
                            transaction_date: '2019-12-30'
                            currency: NGN
                            card_locale: LOCAL
                            rrn: N/A
                            subaccount_settlement: 0
              example:
                status: success
                message: Settlement fetched
                data:
                  id: 41497
                  account_id: 73362
                  merchant_name: Earth Gang
                  merchant_email: selma.m0ckaham@flutterwavego.com
                  settlement_account: '0031318432'
                  bank_code: '063'
                  transaction_date: '2019-12-30T04:00:00.000Z'
                  due_date: '2019-12-30T04:00:00.000Z'
                  processed_date: null
                  status: completed
                  is_local: 1
                  currency: NGN
                  gross_amount: 50800
                  app_fee: 950
                  merchant_fee: 0
                  chargeback: 0
                  refund: 0
                  stampduty_charge: 0
                  net_amount: 49850
                  transaction_count: 5
                  processor_ref: null
                  disburse_ref: RV3E18675549F6A0
                  disburse_message: null
                  channel: web
                  destination: autowallet
                  fx_data: null
                  flag_message: null
                  meta: '[906256,906358,906301,906362,906319]'
                  refund_meta: null
                  chargeback_meta: null
                  source_bankcode: null
                  created_at: '2019-12-31T01:30:00.000Z'
                  transactions:
                    - customer_email: h0vkard@flw.ext
                      flw_ref: FLW-MOCK-RECURR-42b3daee9f470127dacd19560533f3a6
                      tx_ref: Rave-Pages017117571060
                      id: 984411
                      charged_amount: 10140
                      app_fee: 190
                      merchant_fee: 0
                      stampduty_charge: 0
                      settlement_amount: 9950
                      status: successful
                      payment_entity: card
                      transaction_date: '2019-12-30'
                      currency: NGN
                      card_locale: LOCAL
                      rrn: N/A
                      subaccount_settlement: 0
                    - customer_email: h0vkard@flw.ext
                      flw_ref: FLW-MOCK-RECURR-c536481525f02f76409892f517a16300
                      tx_ref: Rave-Pages017117571060
                      id: 984456
                      charged_amount: 10140
                      app_fee: 190
                      merchant_fee: 0
                      stampduty_charge: 0
                      settlement_amount: 9950
                      status: successful
                      payment_entity: card
                      transaction_date: '2019-12-30'
                      currency: NGN
                      card_locale: LOCAL
                      rrn: N/A
                      subaccount_settlement: 0
                    - customer_email: h0vkard@flw.ext
                      flw_ref: FLW-MOCK-RECURR-d22d0ec0955047e9648bec46da40c987
                      tx_ref: Rave-Pages017117571060
                      id: 984474
                      charged_amount: 10190
                      app_fee: 190
                      merchant_fee: 0
                      stampduty_charge: 0
                      settlement_amount: 10000
                      status: successful
                      payment_entity: card
                      transaction_date: '2019-12-30'
                      currency: NGN
                      card_locale: LOCAL
                      rrn: N/A
                      subaccount_settlement: 0
                    - customer_email: h0vkard@flw.ext
                      flw_ref: FLW-MOCK-RECURR-e55f863f14a95816e0939e7c4625ee43
                      tx_ref: Rave-Pages017117571060
                      id: 984513
                      charged_amount: 10190
                      app_fee: 190
                      merchant_fee: 0
                      stampduty_charge: 0
                      settlement_amount: 10000
                      status: successful
                      payment_entity: card
                      transaction_date: '2019-12-30'
                      currency: NGN
                      card_locale: LOCAL
                      rrn: N/A
                      subaccount_settlement: 0
                    - customer_email: h0vkard@flw.ext
                      flw_ref: FLW-MOCK-RECURR-6100e5300876cef2270b2e31bc9cc16e
                      tx_ref: Rave-Pages017117571060
                      id: 984517
                      charged_amount: 10140
                      app_fee: 190
                      merchant_fee: 0
                      stampduty_charge: 0
                      settlement_amount: 9950
                      status: successful
                      payment_entity: card
                      transaction_date: '2019-12-30'
                      currency: NGN
                      card_locale: LOCAL
                      rrn: N/A
                      subaccount_settlement: 0
        '400':
          description: Bad Request
          headers:
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                  example: Thu, 28 Mar 2024 12:03:37 GMT
            Content-Length:
              content:
                text/plain:
                  schema:
                    type: string
                  example: '69'
            Connection:
              content:
                text/plain:
                  schema:
                    type: string
                  example: keep-alive
            Server:
              content:
                text/plain:
                  schema:
                    type: string
                  example: nginx/1.24.0
            Access-Control-Allow-Origin:
              content:
                text/plain:
                  schema:
                    type: string
                  example: '*'
            Access-Control-Allow-Headers:
              content:
                text/plain:
                  schema:
                    type: string
                  example: >-
                    Origin, X-Requested-With, Content-Type, Accept,
                    Authorization, v3-xapp-id, flw-auth-token, mra-auth-token,
                    alt_mode_auth, mid, altmodeauth, cc-admin-token, x-flw-lang
            Access-Control-Allow-Methods:
              content:
                text/plain:
                  schema:
                    type: string
                  example: PUT, POST, GET, DELETE, OPTIONS
            ETag:
              content:
                text/plain:
                  schema:
                    type: string
                  example: W/"45-YDYt4ONyYWV9iFUZqiWd+A"
          content:
            application/json; charset=utf-8:
              schema:
                allOf:
                  - $ref: '#/components/schemas/SampleErrorResponse1'
                  - example:
                      status: error
                      message: No settlement record found
                      data: null
              example:
                status: error
                message: No settlement record found
                data: null
      deprecated: false
components:
  schemas:
    SampleSuccessResponse36:
      title: SampleSuccessResponse36
      required:
        - status
        - message
        - data
      type: object
      properties:
        status:
          type: string
        message:
          type: string
        data:
          $ref: '#/components/schemas/Data92'
      example:
        status: success
        message: Settlement fetched
        data:
          id: 41497
          account_id: 73362
          merchant_name: Earth Gang
          merchant_email: selma.m0ckaham@flutterwavego.com
          settlement_account: '0031318432'
          bank_code: '063'
          transaction_date: '2019-12-30T04:00:00.000Z'
          due_date: '2019-12-30T04:00:00.000Z'
          processed_date: null
          status: completed
          is_local: 1
          currency: NGN
          gross_amount: 50800
          app_fee: 950
          merchant_fee: 0
          chargeback: 0
          refund: 0
          stampduty_charge: 0
          net_amount: 49850
          transaction_count: 5
          processor_ref: null
          disburse_ref: RV3E18675549F6A0
          disburse_message: null
          channel: web
          destination: autowallet
          fx_data: null
          flag_message: null
          meta: '[906256,906358,906301,906362,906319]'
          refund_meta: null
          chargeback_meta: null
          source_bankcode: null
          created_at: '2019-12-31T01:30:00.000Z'
          transactions:
            - customer_email: h0vkard@flw.ext
              flw_ref: FLW-MOCK-RECURR-42b3daee9f470127dacd19560533f3a6
              tx_ref: Rave-Pages017117571060
              id: 984411
              charged_amount: 10140
              app_fee: 190
              merchant_fee: 0
              stampduty_charge: 0
              settlement_amount: 9950
              status: successful
              payment_entity: card
              transaction_date: '2019-12-30'
              currency: NGN
              card_locale: LOCAL
              rrn: N/A
              subaccount_settlement: 0
            - customer_email: h0vkard@flw.ext
              flw_ref: FLW-MOCK-RECURR-c536481525f02f76409892f517a16300
              tx_ref: Rave-Pages017117571060
              id: 984456
              charged_amount: 10140
              app_fee: 190
              merchant_fee: 0
              stampduty_charge: 0
              settlement_amount: 9950
              status: successful
              payment_entity: card
              transaction_date: '2019-12-30'
              currency: NGN
              card_locale: LOCAL
              rrn: N/A
              subaccount_settlement: 0
            - customer_email: h0vkard@flw.ext
              flw_ref: FLW-MOCK-RECURR-d22d0ec0955047e9648bec46da40c987
              tx_ref: Rave-Pages017117571060
              id: 984474
              charged_amount: 10190
              app_fee: 190
              merchant_fee: 0
              stampduty_charge: 0
              settlement_amount: 10000
              status: successful
              payment_entity: card
              transaction_date: '2019-12-30'
              currency: NGN
              card_locale: LOCAL
              rrn: N/A
              subaccount_settlement: 0
            - customer_email: h0vkard@flw.ext
              flw_ref: FLW-MOCK-RECURR-e55f863f14a95816e0939e7c4625ee43
              tx_ref: Rave-Pages017117571060
              id: 984513
              charged_amount: 10190
              app_fee: 190
              merchant_fee: 0
              stampduty_charge: 0
              settlement_amount: 10000
              status: successful
              payment_entity: card
              transaction_date: '2019-12-30'
              currency: NGN
              card_locale: LOCAL
              rrn: N/A
              subaccount_settlement: 0
            - customer_email: h0vkard@flw.ext
              flw_ref: FLW-MOCK-RECURR-6100e5300876cef2270b2e31bc9cc16e
              tx_ref: Rave-Pages017117571060
              id: 984517
              charged_amount: 10140
              app_fee: 190
              merchant_fee: 0
              stampduty_charge: 0
              settlement_amount: 9950
              status: successful
              payment_entity: card
              transaction_date: '2019-12-30'
              currency: NGN
              card_locale: LOCAL
              rrn: N/A
              subaccount_settlement: 0
    SampleErrorResponse1:
      title: SampleErrorResponse1
      required:
        - status
        - message
        - data
      type: object
      properties:
        status:
          type: string
        message:
          type: string
        data:
          type: string
          nullable: true
      example:
        status: error
        message: >-
          retry_interval is required , retry_amount_variable is required ,
          retry_attempt_variable is required
        data: null
    Data92:
      title: Data92
      required:
        - id
        - account_id
        - merchant_name
        - merchant_email
        - settlement_account
        - bank_code
        - transaction_date
        - due_date
        - processed_date
        - status
        - is_local
        - currency
        - gross_amount
        - app_fee
        - merchant_fee
        - chargeback
        - refund
        - stampduty_charge
        - net_amount
        - transaction_count
        - processor_ref
        - disburse_ref
        - disburse_message
        - channel
        - destination
        - fx_data
        - flag_message
        - meta
        - refund_meta
        - chargeback_meta
        - source_bankcode
        - created_at
        - transactions
      type: object
      properties:
        id:
          type: integer
          format: int32
        account_id:
          type: integer
          format: int32
        merchant_name:
          type: string
        merchant_email:
          type: string
        settlement_account:
          type: string
        bank_code:
          type: string
        transaction_date:
          type: string
        due_date:
          type: string
        processed_date:
          type: string
          nullable: true
        status:
          type: string
        is_local:
          type: integer
          format: int32
        currency:
          type: string
        gross_amount:
          type: integer
          format: int32
        app_fee:
          type: integer
          format: int32
        merchant_fee:
          type: integer
          format: int32
        chargeback:
          type: integer
          format: int32
        refund:
          type: integer
          format: int32
        stampduty_charge:
          type: integer
          format: int32
        net_amount:
          type: integer
          format: int32
        transaction_count:
          type: integer
          format: int32
        processor_ref:
          type: string
          nullable: true
        disburse_ref:
          type: string
        disburse_message:
          type: string
          nullable: true
        channel:
          type: string
        destination:
          type: string
        fx_data:
          type: string
          nullable: true
        flag_message:
          type: string
          nullable: true
        meta:
          type: string
        refund_meta:
          type: string
          nullable: true
        chargeback_meta:
          type: string
          nullable: true
        source_bankcode:
          type: string
          nullable: true
        created_at:
          type: string
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/Transaction2'
          description: ''
      example:
        id: 41497
        account_id: 73362
        merchant_name: Earth Gang
        merchant_email: selma.m0ckaham@flutterwavego.com
        settlement_account: '0031318432'
        bank_code: '063'
        transaction_date: '2019-12-30T04:00:00.000Z'
        due_date: '2019-12-30T04:00:00.000Z'
        processed_date: null
        status: completed
        is_local: 1
        currency: NGN
        gross_amount: 50800
        app_fee: 950
        merchant_fee: 0
        chargeback: 0
        refund: 0
        stampduty_charge: 0
        net_amount: 49850
        transaction_count: 5
        processor_ref: null
        disburse_ref: RV3E18675549F6A0
        disburse_message: null
        channel: web
        destination: autowallet
        fx_data: null
        flag_message: null
        meta: '[906256,906358,906301,906362,906319]'
        refund_meta: null
        chargeback_meta: null
        source_bankcode: null
        created_at: '2019-12-31T01:30:00.000Z'
        transactions:
          - customer_email: h0vkard@flw.ext
            flw_ref: FLW-MOCK-RECURR-42b3daee9f470127dacd19560533f3a6
            tx_ref: Rave-Pages017117571060
            id: 984411
            charged_amount: 10140
            app_fee: 190
            merchant_fee: 0
            stampduty_charge: 0
            settlement_amount: 9950
            status: successful
            payment_entity: card
            transaction_date: '2019-12-30'
            currency: NGN
            card_locale: LOCAL
            rrn: N/A
            subaccount_settlement: 0
          - customer_email: h0vkard@flw.ext
            flw_ref: FLW-MOCK-RECURR-c536481525f02f76409892f517a16300
            tx_ref: Rave-Pages017117571060
            id: 984456
            charged_amount: 10140
            app_fee: 190
            merchant_fee: 0
            stampduty_charge: 0
            settlement_amount: 9950
            status: successful
            payment_entity: card
            transaction_date: '2019-12-30'
            currency: NGN
            card_locale: LOCAL
            rrn: N/A
            subaccount_settlement: 0
          - customer_email: h0vkard@flw.ext
            flw_ref: FLW-MOCK-RECURR-d22d0ec0955047e9648bec46da40c987
            tx_ref: Rave-Pages017117571060
            id: 984474
            charged_amount: 10190
            app_fee: 190
            merchant_fee: 0
            stampduty_charge: 0
            settlement_amount: 10000
            status: successful
            payment_entity: card
            transaction_date: '2019-12-30'
            currency: NGN
            card_locale: LOCAL
            rrn: N/A
            subaccount_settlement: 0
          - customer_email: h0vkard@flw.ext
            flw_ref: FLW-MOCK-RECURR-e55f863f14a95816e0939e7c4625ee43
            tx_ref: Rave-Pages017117571060
            id: 984513
            charged_amount: 10190
            app_fee: 190
            merchant_fee: 0
            stampduty_charge: 0
            settlement_amount: 10000
            status: successful
            payment_entity: card
            transaction_date: '2019-12-30'
            currency: NGN
            card_locale: LOCAL
            rrn: N/A
            subaccount_settlement: 0
          - customer_email: h0vkard@flw.ext
            flw_ref: FLW-MOCK-RECURR-6100e5300876cef2270b2e31bc9cc16e
            tx_ref: Rave-Pages017117571060
            id: 984517
            charged_amount: 10140
            app_fee: 190
            merchant_fee: 0
            stampduty_charge: 0
            settlement_amount: 9950
            status: successful
            payment_entity: card
            transaction_date: '2019-12-30'
            currency: NGN
            card_locale: LOCAL
            rrn: N/A
            subaccount_settlement: 0
    Transaction2:
      title: Transaction2
      required:
        - customer_email
        - flw_ref
        - tx_ref
        - id
        - charged_amount
        - app_fee
        - merchant_fee
        - stampduty_charge
        - settlement_amount
        - status
        - payment_entity
        - transaction_date
        - currency
        - card_locale
        - rrn
        - subaccount_settlement
      type: object
      properties:
        customer_email:
          type: string
        flw_ref:
          type: string
        tx_ref:
          type: string
        id:
          type: integer
          format: int32
        charged_amount:
          type: integer
          format: int32
        app_fee:
          type: integer
          format: int32
        merchant_fee:
          type: integer
          format: int32
        stampduty_charge:
          type: integer
          format: int32
        settlement_amount:
          type: integer
          format: int32
        status:
          type: string
        payment_entity:
          type: string
        transaction_date:
          type: string
        currency:
          type: string
        card_locale:
          type: string
        rrn:
          type: string
        subaccount_settlement:
          type: integer
          format: int32
      example:
        customer_email: h0vkard@flw.ext
        flw_ref: FLW-MOCK-RECURR-42b3daee9f470127dacd19560533f3a6
        tx_ref: Rave-Pages017117571060
        id: 984411
        charged_amount: 10140
        app_fee: 190
        merchant_fee: 0
        stampduty_charge: 0
        settlement_amount: 9950
        status: successful
        payment_entity: card
        transaction_date: '2019-12-30'
        currency: NGN
        card_locale: LOCAL
        rrn: N/A
        subaccount_settlement: 0
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````