> ## Documentation Index
> Fetch the complete documentation index at: https://www.cashfree.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Check Transaction Status

> The check transaction status API allows billers to retrieve the current status of a transaction using the unique BBPS transaction ID associated with the bill. This endpoint serves as a reliable method for querying transaction details, providing merchants with real-time updates on payment status.



## OpenAPI

````yaml get /bbps/biller/bill/status/{bbps_transaction_id}
openapi: 3.0.3
info:
  title: BBPS
  version: '4'
servers:
  - url: https://sandbox.cashfree.com/
    description: Testing environment baseUrl
  - url: https://api.cashfree.com/
    description: Production environment baseUrl
security:
  - {}
paths:
  /bbps/biller/bill/status/{bbps_transaction_id}:
    get:
      summary: Check Transaction Status
      description: >-
        The check transaction status API allows billers to retrieve the current
        status of a transaction using the unique BBPS transaction ID associated
        with the bill. This endpoint serves as a reliable method for querying
        transaction details, providing merchants with real-time updates on
        payment status.
      parameters:
        - name: bbps_transaction_id
          in: path
          required: true
          description: Unique identifier for the transaction (BBPS transaction ID).
          schema:
            type: string
            example: test40624
        - name: x-client-id
          in: header
          required: true
          description: Client ID provided by Cashfree.
          schema:
            type: string
            example: your_client_id
        - name: x-client-secret
          in: header
          required: true
          description: Client secret key provided by Cashfree.
          schema:
            type: string
            example: your_client_secret
        - name: Content-Type
          in: header
          required: true
          description: The content type for the request should be application/json.
          schema:
            type: string
            example: application/json
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: |-
                    {
                      "bbps_transaction_id": "test40624",
                      "bill_payment_status": "SUCCESS",
                      "settlement_status": "SETTLED",
                      "settlement_utr": "DUMMYUTR",
                      "settlement_amount": 1,
                      "settlement_time": "2024-07-30 11:39:42"
                    }
              schema:
                type: object
                properties:
                  bbps_transaction_id:
                    type: string
                    description: Unique BBPS transaction ID for the request.
                  bill_payment_status:
                    type: string
                    description: >-
                      Current status of the transaction (e.g. SUCCESS, PENDING,
                      FAILED).
                    enum:
                      - SUCCESS
                      - PENDING
                      - FAILED
                  settlement_status:
                    type: string
                    description: Status of the settlement (SETTLED or null).
                  settlement_utr:
                    type: string
                    description: Unique transaction reference number of the settlement.
                  settlement_amount:
                    type: integer
                    description: Amount of the settlement.
                  settlement_time:
                    type: string
                    format: date-time
                    description: Time of the settlement.
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Invalid BBPS transaction ID:
                  value: |-
                    {
                      "type": "validation_error",
                      "code": "transaction not found",
                      "message": "transaction does not exist for bbps transaction id"
                    }
                Client ID is missing in request:
                  value: |-
                    {
                      "type": "validation_error",
                      "code": "x-client-id_missing",
                      "message": "x-client-id is missing in the request."
                    }
                Client secret key is missing:
                  value: |-
                    {
                      "type": "validation_error",
                      "code": "x-client-secret_missing",
                      "message": "x-client-secret is missing in the request."
                    }
              schema:
                type: object
                properties:
                  type:
                    type: string
                  code:
                    type: string
                  message:
                    type: string
        '401':
          description: '401'
          content:
            application/json:
              examples:
                Result:
                  value: |-
                    {
                      "type": "authentication_error",
                      "code": "request_failed",
                      "message": "authentication failed"
                    }
              schema:
                type: object
                properties:
                  type:
                    type: string
                  code:
                    type: string
                  message:
                    type: string
        '403':
          description: '403'
          content:
            application/json:
              examples:
                Result:
                  value: |-
                    {
                      "type": "authentication_error",
                      "code": "request_failed",
                      "message": "IP not Whitelisted"
                    }
              schema:
                type: object
                properties:
                  type:
                    type: string
                  code:
                    type: string
                  message:
                    type: string
        '429':
          description: '429'
          content:
            application/json:
              examples:
                Result:
                  value: |-
                    {
                      "type": "rate_limit_error",
                      "code": "too_many_requests_per_ip",
                      "message": "Too many requests from the IP, rate limit reached"
                    }
              schema:
                type: object
                properties:
                  type:
                    type: string
                  code:
                    type: string
                  message:
                    type: string
      deprecated: false
      security: []

````