> ## Documentation Index
> Fetch the complete documentation index at: https://docs-terra.withunify.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Applicant Identity

> How Terra manages applicant identity across forms and submissions

# Applicant Identity

> Applicants have a unified identity separate from admin users.

## Identity Model

```mermaid theme={null}
erDiagram
    APPLICANT ||--o{ SUBMISSION : owns
    APPLICANT ||--o| USER_PROFILE : "may have"
    APPLICANT {
        uuid id PK
        string workos_user_id
        string email
        string phone
        boolean email_verified
    }
```

## Anonymous vs Authenticated

Forms can require authentication or allow anonymous submissions:

| Mode          | Identity     | Can Return        |
| ------------- | ------------ | ----------------- |
| Anonymous     | None         | No                |
| Email-linked  | Email only   | Via status lookup |
| Authenticated | Full account | Yes, via portal   |

## Applicant Portal

Authenticated applicants can:

* View all their submissions
* Check application status
* Upload additional documents
* Update contact information

```typescript theme={null}
// Get applicant's submissions
const submissions = await supabaseAdmin
  .from("form_submissions")
  .select("*, forms(*)")
  .eq("applicant_id", applicantId)
  .order("submitted_at", { ascending: false });
```

## Status Lookup

For non-authenticated submissions, applicants can look up status via reference ID:

```
/status?ref=RENT-2024-001
```

***

<Card title="Multi-Tenancy" icon="building" href="/core-systems/identity/multi-tenancy">
  Organization and workspace structure
</Card>