Retrieve Tenants for an Email Address

Retrieve the list of tenants in which an email address exists.

When authenticating using user credentials, you must also include the GUID of the tenant in which the user resides.

To retrieve the list of tenants that hold a user based on a given email address, call GET /v1.0/token/tenants

cURL

curl --location --request GET 'http://localhost:8701/v1.0/token/tenants' \
--header 'x-email: [email protected]'

JavaScript

import { LiteGraphSdk } from 'litegraphdb';

var api = new LiteGraphSdk('http://localhost:8701/', '<Tenant-Guid>', '*******');

const getTenantsForEmail = async () => {
  try {
    const data = await api.Authentication.getTenantsForEmail('[email protected]');
    console.log(data, 'Tenants retrieved successfully');
  } catch (err) {
    console.log('err:', JSON.stringify(err));
  }
};

Python

import litegraph

sdk = litegraph.configure(
    endpoint="http://localhost:8701",
    tenant_guid="Tenant-Guid",
    access_key="******",
)

def retrieve_tenants_for_email():
    tenants = litegraph.Authentication.retrieve_tenants_for_email(email="[email protected]")
    print(tenants)

retrieve_tenants_for_email()

Response

JSON

[
    {
        "GUID": "00000000-0000-0000-0000-000000000000",
        "Name": "Updated tenant",
        "Active": true,
        "CreatedUtc": "2025-08-29T13:54:54.956041Z",
        "LastUpdateUtc": "2025-09-08T10:00:45.175616Z"
    }
]