# Get Your Tenant

The tenant of the signed-in user: its id, name, status, logo and settings. Every role may read it.

## Overview

- `id` is your tenant's id: the `{id}` of the tenant administration routes ([Credentials & Rotation](https://docs.aureahub.com/docs/guide-credentials.md), [Institution Callback & Co-Signer](https://docs.aureahub.com/docs/guide-institution-callback.md)). The access token's `tenantId` claim holds the same value.
- `status` is `active`, `suspended` or `inactive`.
- `configuration` holds your tenant's settings. Read only these keys: `walletMode` (`custodial`, `non_custodial` or `mpc`; absent means `custodial`), `dappsEnabled` (`true` when the dApps browser is on), `bankingProvider` (`gnosis` when your tenant has [Cards & EUR Account](https://docs.aureahub.com/docs/guide-cards.md)), `lumenEnabled` (`true` when it has [Lending](https://docs.aureahub.com/docs/guide-lending.md)) and `primaryColor`. Its other keys are settings Aurea keeps for your tenant: they may change without notice, so don't depend on them. For feature switches, prefer [Available Features](https://docs.aureahub.com/docs/tenant-features.md).
- The API key is never in this answer: [Get the API Key](https://docs.aureahub.com/docs/admin-tenants-apikey.md).

## Endpoint

### `GET /v1/tenant`

Authentication: bearer token required.

Returns the signed-in user's tenant.

**Responses**

`200` OK

```json
{
  "id": "3f1c9a52-6d1e-4c1b-9f0a-2a51e1c0b7d4",
  "name": "Acme Wallet",
  "configuration": {
    "walletMode": "custodial",
    "dappsEnabled": true,
    "primaryColor": "#6142FF"
  },
  "status": "active",
  "logoUrl": "https://api.aureahub.com/v1/uploads/logos/3f1c9a52-6d1e-4c1b-9f0a-2a51e1c0b7d4_1791297243000.png",
  "createdAt": "2026-03-02T09:14:07.000Z",
  "updatedAt": "2026-10-01T16:40:12.000Z"
}
```

**Example request**

```bash
curl https://api.aureahub.com/v1/tenant \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

---

Web version: https://docs.aureahub.com/#tenant-info