> **Source:** https://knowledge.leegality.com/sign-station/api/get-settings
> **Site:** Leegality Knowledge Base — https://knowledge.leegality.com
> **About:** Leegality is a document execution platform covering eSigning, stamps, NeSL, workflows, and REST API integration.
> **Navigation:** Every article on this site has a plain-text version at `<article-url>.txt` (this format). To get an index of all articles with their `.txt` links, read: https://knowledge.leegality.com/llms.txt
> **AI Guide:** For instructions on how to navigate this knowledge base as an AI agent, read: https://knowledge.leegality.com/ai-readable.txt

---
# GET /api/v1/settings — Get settings for current organization

Retrieves settings for the current user's organization

**Authentication:** `X-Auth-Token` header required on every request.

## Request URL

```
GET https://app1.leegality.com/api/api/v1/settings
```

**Environments:**
- Production: `https://app1.leegality.com/api/api/v1/settings`
- Sandbox: `https://sandbox.leegality.com/api/api/v1/settings`

---

## Responses

### 200 — Settings retrieved successfully

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `data` | SettingsVO | No | See **SettingsVO** below. | — |

#### SettingsVO

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `id` | string | No | Settings ID. This is configured during the settings creation. | `ed99d2dd-f44e-4278-a3e2-13a1ed2be13c` |
| `documentRetentionEnabled` | boolean | No | Indicates if document retention is enabled | `true` |
| `documentRetentionPeriod` | integer | No | Document retention period in days | `30` |
| `auditLogsRetentionEnabled` | boolean | No | Indicates if audit logs retention is enabled | `true` |
| `auditLogsRetentionPeriod` | integer | No | Audit logs retention period in days | `90` |
| `auditTrailGenerationEnabled` | boolean | No | Indicates if audit trail generation is enabled | `true` |
| `createdAt` | string | No | The date and time when the settings were created | `2025-12-08T15:28:26` |

### 401 — Unauthorized - Invalid or expired token

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `code` | string | No | Top-level error code | `LE_ERR_SS_401` |
| `errors` | array\<ErrorDetail401Unauthorized\> | No | List of error details See **ErrorDetail401Unauthorized** below. | — |

#### ErrorDetail401Unauthorized

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `message` | string | No | Detailed error message | `Invalid or expired token` |
| `path` | string | No | API path that generated the error | `/api/v1/*` |
| `code` | string | No | Specific error code | `LE_ERR_SS_303` |

### 404 — Settings not found

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `code` | string | No | Top-level error code | `LE_ERR_SS_404` |
| `errors` | array\<ErrorDetailGetSettings404VO\> | No | List of error details See **ErrorDetailGetSettings404VO** below. | — |

#### ErrorDetailGetSettings404VO

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `message` | string | No | Detailed error message | `Settings not found for organization 57270dc1-681d-4cd9-9268-` |
| `path` | string | No | API path that generated the error | `/api/v1/settings` |
| `code` | string | No | Specific error code | `LE_ERR_SS_203` |

### 500 — Internal server error

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `code` | string | No | Top-level error code | `LE_ERR_SS_500` |
| `errors` | array\<ErrorDetailToken500VO\> | No | List of error details See **ErrorDetailToken500VO** below. | — |

#### ErrorDetailToken500VO

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| `message` | string | No | Detailed error message | `Internal Server Error` |
| `path` | string | No | API path that generated the error | `null` |
| `code` | string | No | Specific error code | `null` |

### Sample Response (200)

```json
{
  "data": {
    "id": "ed99d2dd-f44e-4278-a3e2-13a1ed2be13c",
    "documentRetentionEnabled": true,
    "documentRetentionPeriod": 30,
    "auditLogsRetentionEnabled": true,
    "auditLogsRetentionPeriod": 90,
    "auditTrailGenerationEnabled": true,
    "createdAt": "2025-12-08T15:28:26"
  }
}
```