# Introduction

Welcome to the **Delos API** – the gateway to building seamless digital banking experiences. Our API empowers developers to integrate full-cycle banking operations into their applications, enabling secure customer onboarding, account management, transaction processing, and financial reporting.

#### **Key Features**

Our API provides access to:

* **Customer Management**:
  * Authorize and authenticate users
  * Create, edit, and manage customer profiles
  * Submit and process applications (including document uploads)
* **Account Operations**:
  * Open and modify accounts
  * Manage beneficiary accounts (counterparties)
* **Transaction Processing**:
  * Initiate exchanges, withdrawals, and transfers
  * View transaction history and statuses
  * Download payment confirmations and statements
* **Financial Controls**:
  * Configure custom commission structures for end clients

#### **Who Should Use This API?**

* **Partners**: Integrate banking services into your platforms
* **Business Clients**: Automate corporate banking operations
* **Developers**: Build custom financial applications on our infrastructure

#### **Best practices (general)**

#### 1. **Start with Postman** 

We recommend using [Postman](https://www.postman.com/) to test our API before writing code:

* **Import our Postman Collection**:

1. Export our postman collection on the Overview page

<figure><img src="/files/juk4LOxpq2yZaJ4cUN61" alt=""><figcaption></figcaption></figure>

2. Open Postman → Click "Import" → Upload the file. There will be two options, "Partner OpenAPI Specification" and "Work with the definition file along with an exclusive collection".

* **Choose "Partner OpenAPI"** if:
  * You're comfortable building requests from scratch
  * You need to modify the API definition itself
  * You're integrating with other tools that consume OpenAPI specs
* **Choose "Exclusive Collection"** if:
  * You want to start testing immediately
  * You're new to Postman or this API
  * You want pre-built examples and workflows

<figure><img src="/files/SVkhF2xjCBaEBmHrj8FG" alt=""><figcaption></figcaption></figure>

3. All endpoints will appear in your workspace

* **Set Up Environment Variables**:

*Pro Tip:* Use <https://stagep.tst-apidmndelss.com/v2/account> in requests – change environments (Sandbox/Production) instantly.

```markdown
1. Create a new environment (e.g., "Sandbox")
2. Add variables:
   - `base_url`: `https://stagep.tst-apidmndelss.com`
   - `api_key`: Your test API key (can be obtained via POST/auth/login)

```

<mark style="color:blue;">**For your convenience, we have created a full Postman collection that is available in this file:**</mark>

{% file src="/files/zPDDyxISTMGuza0rltub" %}

#### 2. **Authentication Made Easy**

* **Store Tokens Securely**:

Add this to your request's "Headers":

Key: `Authorization` Value: `Bearer {{auth_token}}`

Use Postman’s "Authorization" tab to auto-include tokens

* **Auto-Refresh Tokens**: Set up a [Postman pre-request script](https://learning.postman.com/docs/writing-scripts/pre-request-scripts/) to handle OAuth 2.0 renewal.

#### 3. **Testing & Debugging**

* **Use Postman Tests**: Add basic checks to verify responses:

  ```jsx
  // Example test in Postman's "Tests" tab
  pm.test("Status code is 200", () => pm.response.to.have.status(200));
  pm.test("Response has accounts array", () => {
      const jsonData = pm.response.json();
      pm.expect(jsonData.items).to.be.an('array');
  });

  ```

#### 4. **Production Readiness**

* **Export Code Snippets**:

  ```markdown
  1. In Postman, click "Code" (right of "Send")
  2. Select your language (Python, Node.js, etc.)
  3. Copy/paste into your application

  ```
* **Document Your Work**: Use Postman’s "Documentation" feature to generate internal API docs for your team.

#### 5. **Security Essentials**

* **Never Hardcode Secrets**: Store API keys in Postman’s "Secrets" or environment variables – *never in shared collections*.
* **Mask Sensitive Data**: Enable "Hide Variable Values" in Postman settings.

***

#### Postman Quick Reference Cheat Sheet

| Action             | How To                                                |
| ------------------ | ----------------------------------------------------- |
| **Save a request** | Click "Save" after testing → Choose collection        |
| **Reuse values**   | Use `{{variable_name}}` syntax                        |
| **Debug errors**   | Check Postman Console (`View → Show Postman Console`) |
| **Share configs**  | Export collections/environments as JSON files         |

**Need Help?**

* [Postman Learning Center](https://learning.postman.com/)


---

# 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.delos.financial/introduction.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.