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

# Lookup Remita RRR Invoice

> Verify any 12-digit Remita Retrieval Reference (RRR) and retrieve due balance, biller name, and payer details.

Look up and verify an existing Remita Retrieval Reference (RRR) invoice.

### Why Use This?

* Verifies official MDA or university name before the customer approves debit.
* Auto-resolves the exact invoice amount so the customer doesn't have to enter it manually.
* Checks live payment status (`PENDING` vs `PAID`).

### Sample Request

```bash theme={null}
curl --request GET \
  --url 'https://api-local.handle.ng/api/v1/bill-payment/rrr/lookup/220799679350' \
  --header 'Authorization: Bearer sk_test_handle_master_key'
```


## OpenAPI

````yaml openapi.json GET /bill-payment/rrr/lookup/{rrr}
openapi: 3.0.3
info:
  title: Handle Merchant Payment Gateway API
  description: >-
    Developer API specification for accepting cardless, instant
    Account-to-Account (A2A) payments via Handle.
  version: 1.0.0
  contact:
    name: Handle Developer Support
    email: support@handle.ng
    url: https://handle.ng
servers:
  - url: https://api-local.handle.ng/api/v1
    description: Local Development (SSL)
  - url: https://api.handle.ng/api/v1
    description: Production Live Gateway
security:
  - BearerAuth: []
paths:
  /bill-payment/rrr/lookup/{rrr}:
    get:
      tags:
        - VAS & Bill Payments
      summary: Lookup Remita RRR Invoice
      description: >-
        Verify and inspect an existing Remita Retrieval Reference (RRR) to view
        payable amount, MDA / biller name, service type, and payer info.
      parameters:
        - name: rrr
          in: path
          required: true
          description: 12-digit Remita Retrieval Reference (e.g. 220799679350)
          schema:
            type: string
            default: '220799679350'
          example: '220799679350'
      responses:
        '200':
          description: RRR invoice details and verified billing status
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      rrr:
                        type: string
                        example: '220799679350'
                      billerId:
                        type: string
                        example: SPECSELECTRICITY
                      billerName:
                        type: string
                        example: ABUJA ELECTRICITY DISTRIBUTION COMPANY
                      productName:
                        type: string
                        example: AEDC Prepaid
                      categoryId:
                        type: string
                        example: '3'
                      categoryName:
                        type: string
                        example: Utilities
                      name:
                        type: string
                        example: Ayodeji Peters
                      phoneNumber:
                        type: string
                        example: '08012345678'
                      email:
                        type: string
                        example: ayodeji@example.com
                      amount:
                        type: number
                        example: 1000
                      fee:
                        type: number
                        example: 0
                      rrrAmount:
                        type: number
                        example: 1000
                      currency:
                        type: string
                        example: NGN
                      status:
                        type: string
                        example: PENDING
                      description:
                        type: string
                        example: AEDC Prepaid Token Invoice
              example:
                success: true
                data:
                  rrr: '220799679350'
                  billerId: SPECSELECTRICITY
                  billerName: ABUJA ELECTRICITY DISTRIBUTION COMPANY
                  productName: AEDC Prepaid
                  categoryId: '3'
                  categoryName: Utilities
                  name: Ayodeji Peters
                  phoneNumber: '08012345678'
                  email: ayodeji@example.com
                  amount: 1000
                  fee: 0
                  rrrAmount: 1000
                  currency: NGN
                  status: PENDING
                  description: AEDC Electricity Vend Invoice
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Supply your secret API key (e.g. `sk_live_...` or `sk_test_...`) in the
        Authorization header.
      x-default: sk_test_handle_master_key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.