Moniepoint

Moniepoint Reserved Accounts API

Manage dedicated and invoice reserved NUBAN accounts.

Documentation GitHub OpenAPI

Operations 7

POST /api/v2/bank-transfer/reserved-accounts Monnify Reserve A Customer Account (V2) #

PUT /api/v2/bank-transfer/reserved-accounts Monnify Update Reserved Account KYC #

GET /api/v2/bank-transfer/reserved-accounts/{accountReference} Monnify Get Reserved Account Details (V2) #

DELETE /api/v2/bank-transfer/reserved-accounts/{accountReference} Monnify Deallocate Reserved Account #

GET /api/v1/bank-transfer/reserved-accounts/transactions Monnify List Reserved Account Transactions #

POST /api/v1/bank-transfer/reserved-accounts/limit Monnify Reserve Account With Limit #

PUT /api/v1/bank-transfer/reserved-accounts/limit Monnify Update Reserved Account Limit #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/moniepoint-reserved-accounts-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Monnify Reserved Accounts API
  description: 'Provision permanent NUBAN virtual accounts (dedicated and invoice variants) for customers and merchants. V2 endpoints replace earlier /api/v1 routes for new integrations; transaction listing remains under /api/v1.

    '
  version: '2.0'
  contact:
    name: Monnify Developer Support
    url: https://developers.monnify.com
servers:
- url: https://api.monnify.com
  description: Production
- url: https://sandbox.monnify.com
  description: Sandbox
security:
- BearerAuth: []
tags:
- name: Reserved Accounts
  description: Manage dedicated and invoice reserved NUBAN accounts.
paths:
  /api/v2/bank-transfer/reserved-accounts:
    post:
      summary: Monnify Reserve A Customer Account (V2)
      description: Create a permanent NUBAN virtual account for a customer.
      operationId: reserveAccountV2
      tags:
      - Reserved Accounts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReserveAccountRequest'
      responses:
        '200':
          description: Reserved account created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReservedAccountEnvelope'
    put:
      summary: Monnify Update Reserved Account KYC
      description: Update BVN, NIN, or customer details for a reserved account.
      operationId: updateReservedAccountKyc
      tags:
      - Reserved Accounts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateKycRequest'
      responses:
        '200':
          description: KYC updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReservedAccountEnvelope'
  /api/v2/bank-transfer/reserved-accounts/{accountReference}:
    get:
      summary: Monnify Get Reserved Account Details (V2)
      description: Fetch a single reserved account by accountReference.
      operationId: getReservedAccountV2
      tags:
      - Reserved Accounts
      parameters:
      - name: accountReference
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Reserved account details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReservedAccountEnvelope'
    delete:
      summary: Monnify Deallocate Reserved Account
      description: Permanently deallocate a reserved account.
      operationId: deallocateReservedAccount
      tags:
      - Reserved Accounts
      parameters:
      - name: accountReference
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Account deallocated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReservedAccountEnvelope'
  /api/v1/bank-transfer/reserved-accounts/transactions:
    get:
      summary: Monnify List Reserved Account Transactions
      description: Paginated list of inbound transactions to a reserved account.
      operationId: listReservedAccountTransactions
      tags:
      - Reserved Accounts
      parameters:
      - name: accountReference
        in: query
        required: true
        schema:
          type: string
      - name: page
        in: query
        schema:
          type: integer
          default: 0
      - name: size
        in: query
        schema:
          type: integer
          default: 10
      responses:
        '200':
          description: Transaction page.
          content:
            application/json:
              schema:
                type: object
                properties:
                  requestSuccessful:
                    type: boolean
                  responseMessage:
                    type: string
                  responseCode:
                    type: string
                  responseBody:
                    type: object
                    properties:
                      content:
                        type: array
                        items:
                          type: object
                      totalElements:
                        type: integer
                      totalPages:
                        type: integer
  /api/v1/bank-transfer/reserved-accounts/limit:
    post:
      summary: Monnify Reserve Account With Limit
      description: Create a reserved account with a pre-assigned limit profile.
      operationId: reserveAccountWithLimit
      tags:
      - Reserved Accounts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ReserveAccountRequest'
              - type: object
                properties:
                  limitProfileCode:
                    type: string
      responses:
        '200':
          description: Reserved account with limit created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReservedAccountEnvelope'
    put:
      summary: Monnify Update Reserved Account Limit
      description: Assign or change the limit profile on an existing reserved account.
      operationId: updateReservedAccountLimit
      tags:
      - Reserved Accounts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - accountReference
              - limitProfileCode
              properties:
                accountReference:
                  type: string
                limitProfileCode:
                  type: string
      responses:
        '200':
          description: Reserved account limit updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReservedAccountEnvelope'
components:
  schemas:
    ReserveAccountRequest:
      type: object
      required:
      - accountReference
      - accountName
      - currencyCode
      - contractCode
      - customerEmail
      properties:
        accountReference:
          type: string
        accountName:
          type: string
        currencyCode:
          type: string
          example: NGN
        contractCode:
          type: string
        customerEmail:
          type: string
          format: email
        customerName:
          type: string
        bvn:
          type: string
          description: Customer BVN (11 digits).
        nin:
          type: string
          description: Customer NIN (11 digits).
        getAllAvailableBanks:
          type: boolean
        preferredBanks:
          type: array
          items:
            type: string
            description: Bank code.
        restrictPaymentSource:
          type: boolean
        allowedPaymentSources:
          type: object
          properties:
            bvns:
              type: array
              items:
                type: string
            accountNumbers:
              type: array
              items:
                type: object
                properties:
                  accountNumber:
                    type: string
                  bankCode:
                    type: string
            accountNames:
              type: array
              items:
                type: string
        incomeSplitConfig:
          type: array
          items:
            type: object
            properties:
              subAccountCode:
                type: string
              feePercentage:
                type: number
              splitPercentage:
                type: number
              feeBearer:
                type: boolean
    ReservedAccountEnvelope:
      type: object
      properties:
        requestSuccessful:
          type: boolean
        responseMessage:
          type: string
        responseCode:
          type: string
        responseBody:
          $ref: '#/components/schemas/ReservedAccount'
    UpdateKycRequest:
      type: object
      properties:
        accountReference:
          type: string
        bvn:
          type: string
        nin:
          type: string
    ReservedAccount:
      type: object
      properties:
        accountReference:
          type: string
        accountName:
          type: string
        currencyCode:
          type: string
        customerEmail:
          type: string
        customerName:
          type: string
        bvn:
          type: string
        nin:
          type: string
        status:
          type: string
          enum:
          - ACTIVE
          - INACTIVE
          - DEALLOCATED
        accounts:
          type: array
          items:
            type: object
            properties:
              bankCode:
                type: string
              bankName:
                type: string
              accountNumber:
                type: string
              accountName:
                type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

Moniepoint Reserved Accounts API

Operations 7

Documentation

Specifications

Schemas & Data

Other Resources