---
agentTools:
  projectIndex: https://safehavenmfb.readme.io/llms.txt
---

# Name Enquiry

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Safe Haven IBS API",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.sandbox.safehavenmfb.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://example.com/oauth2/token",
            "scopes": {}
          }
        }
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/transfers/name-enquiry": {
      "post": {
        "summary": "Name Enquiry",
        "description": "",
        "operationId": "name-enquiry",
        "parameters": [
          {
            "name": "ClientID",
            "in": "header",
            "description": "This is your 'ibs_client_id' returned in the response when you generate an api token",
            "required": true,
            "schema": {
              "type": "string",
              "default": "471332960a20c026aca3b6364f2c6be0"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "bankCode",
                  "accountNumber"
                ],
                "properties": {
                  "bankCode": {
                    "type": "string",
                    "description": "The bank code of the bank for the account you want to perform an enquiry for.",
                    "default": "999240"
                  },
                  "accountNumber": {
                    "type": "string",
                    "description": "The account number of the account to perform the enquiry for.",
                    "default": "0106664982"
                  }
                }
              },
              "examples": {
                "Request Example": {
                  "value": {
                    "statusCode": 200,
                    "responseCode": "00",
                    "message": "Approved or completed successfully",
                    "data": {
                      "responseCode": "00",
                      "responseMessage": "Approved or completed successfully",
                      "sessionId": "999240251124101245674114910662",
                      "bankCode": "999240",
                      "accountNumber": "0106664982",
                      "accountName": "PRIMETECH / HOUSE RENT",
                      "kycLevel": "3",
                      "bvn": "22368809000"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"statusCode\": 200,\n    \"responseCode\": \"00\",\n    \"message\": \"Approved or completed successfully\",\n    \"data\": {\n        \"responseCode\": \"00\",\n        \"responseMessage\": \"Approved or completed successfully\",\n        \"sessionId\": \"999240230705103301782413638076\",\n        \"bankCode\": \"999240\",\n        \"accountNumber\": \"0110654321\",\n        \"accountName\": \"BITAKO TECHNOLOGIES LIMITED\",\n        \"kycLevel\": \"3\",\n        \"bvn\": \"***********\"\n    }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 200,
                      "default": 0
                    },
                    "responseCode": {
                      "type": "string",
                      "example": "00"
                    },
                    "message": {
                      "type": "string",
                      "example": "Approved or completed successfully"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "responseCode": {
                          "type": "string",
                          "example": "00"
                        },
                        "responseMessage": {
                          "type": "string",
                          "example": "Approved or completed successfully"
                        },
                        "sessionId": {
                          "type": "string",
                          "example": "999240230705103301782413638076"
                        },
                        "bankCode": {
                          "type": "string",
                          "example": "999240"
                        },
                        "accountNumber": {
                          "type": "string",
                          "example": "0110654321"
                        },
                        "accountName": {
                          "type": "string",
                          "example": "BITAKO TECHNOLOGIES LIMITED"
                        },
                        "kycLevel": {
                          "type": "string",
                          "example": "3"
                        },
                        "bvn": {
                          "type": "string",
                          "example": "***********"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true,
  "_id": "61e69ed05b7bd4006a962eed:61ea80ed1992630031f28ee5"
}
```