Skip to main content
POST
Bill Fetch Request

Authorizations

x-client-id
string
header
required

Your unique client identifier issued by Cashfree. You can find this in your Merchant Dashboard.

x-client-secret
string
header
required

Your unique client secret issued by Cashfree. Keep this confidential and never expose it in client-side code. You can find this in your Merchant Dashboard.

Headers

x-api-version
enum<string>
default:2025-01-01

API version to be used. Format is YYYY-MM-DD. The only supported version for this API is 2025-01-01. If not specified, 2025-01-01 is used.

Available options:
2025-01-01

Body

application/json

Request parameters to initiate a bill fetch or bill validation request.

bill_fetch_request
object
required

Response

Final result returned in the same call. Returned only when synchronous responses are enabled for your account and the result is ready within the synchronous wait period.

status
string

The status of the API call. Returns OK when the request is successfully processed and the final result is available in the same call. This field indicates the API call succeeded. The outcome of the bill fetch operation is available in the data object.

Example:

"OK"

message
enum<string>

Final outcome of the bill fetch or bill validation request. The possible values match the message values that the Bill Fetch Response API returns.

Available options:
Bill details fetched successfully,
Bill request failed
data
object

Contains the final result of the bill fetch request.