# Local Status

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

Where the user stands, from Aurea's own records — no call to the card program, so it never fails on an expired session. Call it whenever your app opens.

## Overview

- `hasSession`: whether the user's card program session is open (not expired). Without one, sign in ([The Card Program Session](https://docs.aureahub.com/docs/guide-cards.md)).
- `status`: `pending`, `terms_accepted`, `source_of_funds_completed`, `mobile_verified` or `active` (the EUR account is active); `null` before the first sign-in.
- `gnosisAddress`: the user's smart account, or `null`. `eurAccountLinked`: whether the address that signs payouts is linked to the EUR account.
- `metadata`: what Aurea last read of the account (`user`, as [Get the Account](https://docs.aureahub.com/docs/cards-user.md) answered it, with the time of the read).
- [Coming soon, upon request](https://docs.aureahub.com/docs/feature-availability.md) `403` until cards are on for your tenant.

## Endpoint

### `GET /v1/gnosis/local-status`

Authentication: bearer token required.

The user's card program status from Aurea's records.

**Responses**

`200` OK

```json
{
  "hasSession": true,
  "status": "active",
  "gnosisAddress": "0x7a1c…e3b2",
  "eurAccountLinked": true,
  "metadata": {
    "lastUserSync": "2026-10-14T08:55:12.000Z",
    "user": { "kycStatus": "approved", "isPhoneValidated": true }
  }
}
```

`200` Never Signed In

```json
{
  "hasSession": false,
  "status": null,
  "gnosisAddress": null,
  "metadata": {},
  "eurAccountLinked": false
}
```

**Example request**

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

---

Web version: https://docs.aureahub.com/#cards-local-status