# Admin: Filer Aliases — Finradar API
> Version: 3.61.0 | Generated: 2026-06-20 | Content Hash: 7aede6b3
> Fetch this file at: https://uat.finradarapi.com/llms/admin-filer-aliases.txt

## Authentication
All endpoints require an API key. Pass it via query parameter `?apiKey=YOUR_KEY` or header `X-API-Key: YOUR_KEY`. WebSocket endpoints accept the key in the `token` auth payload or query parameter.

---

## Admin: Filer Aliases

Manage the curated filer_aliases table that maps well-known fund manager names, nicknames, and abbreviations to their institutional fund CIKs. These aliases power the /form-13f/filers search — e.g. searching 'buffett' finds Berkshire Hathaway, 'ackman' finds Pershing Square.

### GET /api/v1/admin/filer-aliases

List all filer aliases, optionally filtered by search term or CIK.

**Token cost:** 0 (EXEMPT — auth / billing / account / admin / health)

**Utility:** Browse or search the alias database. Useful for auditing existing mappings before adding new ones.

**Use case:** Checking which aliases already exist for a fund, or finding all aliases that contain 'tiger'.

**Parameters:**
- `q` (query, optional): Search aliases by name (case-insensitive substring match)
- `cik` (query, optional): Filter aliases by CIK (exact match)

### POST /api/v1/admin/filer-aliases

Add a new filer alias mapping.

**Token cost:** 0 (EXEMPT — auth / billing / account / admin / health)

**Utility:** Create a new alias that maps a well-known name or abbreviation to a fund CIK. Once added, the alias is immediately searchable in the /form-13f/filers endpoint.

**Use case:** Adding 'Uncle Warren' as an alias for Berkshire Hathaway (CIK 0001067983), or 'RenTech' for Renaissance Technologies.

**Parameters:**
- `alias_name` (body, required): The alias string (e.g. 'buffett', 'ackman', 'RenTech')
- `cik` (body, required): The fund CIK this alias maps to (e.g. '0001067983')
- `alias_type` (body, optional): Category of alias (e.g. 'manager_name', 'nickname', 'abbreviation')
- `notes` (body, optional): Optional notes about this alias

### PUT /api/v1/admin/filer-aliases/:id

Update an existing filer alias by its ID.

**Token cost:** 0 (EXEMPT — auth / billing / account / admin / health)

**Utility:** Modify the alias name, type, or notes for an existing alias mapping.

**Use case:** Correcting a typo in an alias name, changing alias_type from 'nickname' to 'manager', or adding notes.

**Parameters:**
- `id` (path, required): Alias record ID
- `alias_name` (body, optional): Updated alias name
- `alias_type` (body, optional): Updated alias type (manager, founder, nickname, ticker, abbreviation)
- `notes` (body, optional): Updated notes

### DELETE /api/v1/admin/filer-aliases/:id

Delete a filer alias by its ID.

**Token cost:** 0 (EXEMPT — auth / billing / account / admin / health)

**Utility:** Remove an incorrect or outdated alias mapping.

**Use case:** Cleaning up a misattributed alias or removing a duplicate entry.

**Parameters:**
- `id` (path, required): Alias record ID

### POST /api/v1/admin/filer-aliases/bulk

Bulk add multiple filer aliases in one request.

**Token cost:** 0 (EXEMPT — auth / billing / account / admin / health)

**Utility:** Efficiently seed or update the aliases table with multiple mappings at once.

**Use case:** Initial seeding of 50+ well-known fund manager aliases, or importing aliases from a spreadsheet.

**Parameters:**
- `aliases` (body, required): Array of alias objects, each with: alias_name (required), cik (required), alias_type (optional), notes (optional)