> ## 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. # Fetch Agent Wallet Ledger > Use this API to fetch a paginated list of wallet ledger entries for a given Agent Institution. Includes credits (recharges) and debits (bill payments). Results can be filtered by date range, transaction type, or UTR. All request body fields are optional. An empty body returns all entries. ## OpenAPI ````yaml /openapi/bbps/bbps-cou.yaml post /bbps/cou/agent/{agentId}/wallet/ledger openapi: 3.0.3 info: title: BBPS for Customers (Customer Operating Unit) version: 1.0.0 description: > APIs for Agent Institutions to integrate with the Bharat Bill Payment System (BBPS) as a Customer Operating Unit (COU). These APIs enable bill discovery, bill fetch, bill payment, complaint management, and wallet operations. servers: - url: https://sandbox.cashfree.com description: Sandbox (Testing) environment. - url: https://api.cashfree.com description: Production environment. security: - XClientID: [] XClientSecret: [] paths: /bbps/cou/agent/{agentId}/wallet/ledger: post: tags: - Wallet summary: Fetch Agent Wallet Ledger description: > Use this API to fetch a paginated list of wallet ledger entries for a given Agent Institution. Includes credits (recharges) and debits (bill payments). Results can be filtered by date range, transaction type, or UTR. All request body fields are optional. An empty body returns all entries. operationId: fetchAgentWalletLedger parameters: - name: agentId in: path required: true description: The BBPS Agent ID (bbpsAgentId) of the Agent Institution. schema: type: string example: OU01XXXXINT001123456 - name: page in: query required: false description: Zero-indexed page number. Default is 0. schema: type: integer default: 0 example: 0 - name: size in: query required: false description: Number of entries per page. Default is 20. schema: type: integer default: 20 example: 20 requestBody: description: Request parameters to filter wallet ledger entries. required: false content: application/json: schema: type: object properties: start_date_time: type: string description: >- Filter entries from this datetime. Format: yyyy-MM-dd HH:mm:ss. example: '2025-01-01 00:00:00' end_date_time: type: string description: >- Filter entries up to this datetime. Format: yyyy-MM-dd HH:mm:ss. example: '2025-01-31 23:59:59' sale_type: type: string description: Filter by transaction type. enum: - CREDIT - DEBIT example: DEBIT utr: type: string description: Filter by Unique Transaction Reference number. example: UTR123456789 example: start_date_time: '2025-01-01 00:00:00' end_date_time: '2025-01-31 23:59:59' sale_type: DEBIT utr: UTR123456789 responses: '200': description: >- Success response for fetching a paginated list of wallet ledger entries for a given Agent Institution. content: application/json: schema: type: object properties: content: type: array description: List of ledger entries for the current page. items: type: object properties: id: type: integer description: Unique ledger entry ID. example: 1001 wallet_id: type: integer description: Internal wallet ID. example: 42 sale_type: type: string enum: - CREDIT - DEBIT example: DEBIT amount: type: number description: Transaction amount in INR. example: 250 closing_balance: type: number description: Wallet balance after this transaction in INR. example: 4750 utr: type: string description: Unique Transaction Reference number. example: UTR123456789 added_on: type: string description: 'Entry creation datetime. Format: yyyy-MM-dd HH:mm:ss' example: '2025-01-15 10:30:00' updated_on: type: string description: >- Entry last updated datetime. Format: yyyy-MM-dd HH:mm:ss example: '2025-01-15 10:30:05' size: type: integer description: Number of entries per page. example: 20 page: type: integer description: Current page number (zero-indexed). example: 0 last: type: boolean description: Indicates whether this is the last page. example: true example: content: - id: 1001 wallet_id: 42 sale_type: DEBIT amount: 250 closing_balance: 4750 utr: UTR123456789 added_on: '2025-01-15 10:30:00' updated_on: '2025-01-15 10:30:05' size: 20 page: 0 last: true '400': description: Bad request error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Authentication Error. content: application/json: schema: $ref: '#/components/schemas/UnauthorizedResponse' '500': description: API related Error. components: schemas: ErrorResponse: type: object properties: status: type: string example: BAD_REQUEST message: type: string example: Validation error description data: nullable: true example: null UnauthorizedResponse: type: object properties: message: type: string example: Unauthorized securitySchemes: XClientID: type: apiKey in: header name: x-client-id description: >- Your unique client identifier issued by Cashfree. You can find this in your [Merchant Dashboard](https://merchant.cashfree.com/verificationsuite/developers/api-keys). XClientSecret: type: apiKey in: header name: x-client-secret description: >- 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](https://merchant.cashfree.com/verificationsuite/developers/api-keys). ````