# Get the Institution Callback Settings

> Coming soon, upon request — this feature is turned on for your tenant by the Aurea team. [Contact us](https://www.aureahub.com/contact)

Your tenant's callback settings, both environments at once.

## Overview

- `environments.production` and `environments.sandbox`: each environment's settings, or `null` where none were saved — the callback is then off there.
- Each: `mode`, `url`, `publicKeys` (each with its `kid`, the RFC 7638 thumbprint your answers name), `fallback` as stored and `effectiveFallback` — the one that applies: always `reject` for a tenant on the institutional security profile —, `retry`, `approvals`, `version` and `updatedAt`. The rules are in [Institution Callback & Co-Signer](https://docs.aureahub.com/docs/guide-institution-callback.md).
- Nothing is asked of your endpoint until your tenant has institution callbacks [Coming soon, upon request](https://docs.aureahub.com/docs/feature-availability.md), whatever this says.
- For `owner`, `tenantadmin`, `non_signing_admin`, `auditor`, `security_admin` and `security_auditor`, on their own tenant.

## Endpoint

### `GET /v1/admin/tenants/{id}/institution-callback`

Authentication: bearer token required.

Both environments' callback settings, null where none were saved.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | yes | Tenant UUID |

**Responses**

`200` OK

```json
{
  "tenantId": "6f1e2d3c-4b5a-4968-8776-a5b4c3d2e1f0",
  "environments": {
    "production": null,
    "sandbox": {
      "environment": "sandbox",
      "mode": "on",
      "url": "https://callback.example.com/aurea",
      "publicKeys": [
        {
          "kty": "EC",
          "crv": "P-256",
          "x": "5UHN8QYz8fLoGG81Tz-RFxcoaVCaSbbcoPZW6yzGzPc",
          "y": "bl4qqX2I3FUE6iUtK-6C_5-ebJ9F51oDHjN0Pvtqn54",
          "kid": "Cenbim1mvDgvFI0QH5-cJ5VDSCnXKkrqQ7IsgOxDYKQ"
        }
      ],
      "fallback": "reject",
      "effectiveFallback": "reject",
      "retry": { "maxSeconds": 172800, "intervalSeconds": 60 },
      "approvals": { "mode": "off", "approverUserId": null },
      "version": 2,
      "updatedAt": "2026-10-14T08:55:12.418Z"
    }
  }
}
```

**Example request**

```bash
curl "https://api.aureahub.com/v1/admin/tenants/6f1e2d3c-4b5a-4968-8776-a5b4c3d2e1f0/institution-callback" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

---

Web version: https://docs.aureahub.com/#institution-callback-get