# Getting Started

To begin integrating the Bell BASS API:

1. Obtain your API key from the Bell BASS developer portal.
2. Familiarize yourself with the API endpoints and the required request/response formats.
3. Start by integrating the service most critical to your application, whether it’s bank transfers, virtual accounts, utility bill payments, or webhooks.
4. Implement comprehensive error handling and security measures.

By following this guide, you can seamlessly integrate the Bell BASS API into your application, providing robust and secure financial services to your users.

For more detailed information, please refer to the Bell BASS API Reference Documentation or contact our support team at <support@bellmfb.com>.

```
BASE URL SANDBOX: https://sandbox-baas-api.bellmfb.com
BASE URL PRODUCTION: https://baas-api.bellmfb.com
```

## Generate Token

Use **consumerKey**, **consumerSecret** and **validityTime** at the header to generate a tok

`POST` `/v1/generate-token`

Use **consumerKey**, **consumerSecret** and **validityTime** at the header to generate a token&#x20;

**Headers**

| Name           | Value                | Description               |
| -------------- | -------------------- | ------------------------- |
| Content-Type   | `application/json`   |                           |
| consumerKey    | `{{consumerKey}}`    | obtain from the dashboard |
| consumerSecret | `{{consumerSecret}}` | obtain from the dashboard |
| validityTime   | `{{validityTime}}`   | in minutes Max 48 Hours   |

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "success": true,
    "message": "Token generated successfully",
    "token": "eyJhbGciOiJIUz9.eyJidXNpbmVzc0lkIjoyMCwidXNlcklkIjo1NDIsInN0YXR1cyI6ImIsImlhdCI6MTcxNjczNzQ0NX0.Avy8w4f-B3432zBeo9a7HXdI1M4XvARVO_XGo"
}
```

{% endtab %}

{% tab title="400" %}

```json
{
    "success": false,
    "message": "Failed to generate token",
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bellmfb.com/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.