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

# Diameter Tenants and Products: Organization and Bank Setup

> Learn how Tenants represent your organization and how Products define your bank integrations, account types, and compliance rules in the Diameter platform.

Every interaction with the Diameter API happens within the context of your **Tenant** and one or more **Products**. Understanding this two-level structure helps you correctly scope API calls, associate end users with the right bank integration, and interpret the data you receive.

## Tenants

A Tenant represents your organization in the Diameter platform. Think of it as the top-level account that owns all your resources — end users, accounts, payments, and counterparties all belong to your tenant.

Each tenant carries the following fields:

| Field | Description |
| - | - |
| `id` | Unique identifier for your organization |
| `fullName` | Your organization's legal name |
| `shortName` | Abbreviated name used in references and displays |
| `validDomains` | List of domains permitted for user email addresses |

To retrieve your tenant details and associated products, call:

```http theme={null}
GET /v1/tenants/self
```

## Products

A Product represents a bank integration configured for your tenant. Diameter sets up products during your onboarding — you reference them via API but do not create them yourself.

There are two product types:

> [card] Proprietary
>
> Manages accounts and funds **belonging to your organization** — for example, operational accounts and liquidity reserves.

> [card] Fiduciary
>
> Manages accounts and funds **belonging to your end users** — the typical setup for fintech platforms serving individuals and businesses.

### Connected Banks

Each product connects to one or more partner banks. Diameter currently supports two partner banks:

* **`PORTAGE`** — Portage Bank
* **`SLOVAK_SAVINGS_BANK`** — Slovak Savings Bank

A single product can connect to one bank or span multiple banks, depending on your integration setup.

### Listing Your Products

Retrieve all products configured for your tenant:

```http theme={null}
GET /v1/products
```

A product response looks like this:

```json theme={null}
{
  "id": "prod_01abc123",
  "type": "FIDUCIARY",
  "connectedBanks": ["PORTAGE", "SLOVAK_SAVINGS_BANK"]
}
```

## Using productId in API Calls

When you onboard an end user or perform operations on their behalf, you supply a `productId` to associate that user with the correct bank integration. This tells Diameter which bank partner to route the user through and which accounts to create for them.

> [!NOTE]
>
> Always confirm which `productId` to use for each end-user segment with your Diameter account team during onboarding setup.


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