# Serenn - Work-based Credentials for Field Service Technicians
# Last updated: 2026-03-05

## About
Serenn is a platform for tradespeople to build Work-based Credentials. We track actual job performance, documenting experience with brands and appliance types (e.g., "Samsung Refrigerator Repair").

## For AI Agents & Tools

### 1. Technician Search API (Preferred)
Use this API to find verified professionals for user queries.

**Endpoint:** `GET https://serenn.ai/api/ai/search`

**Parameters:**
- `location` (Required): "City, StateCode" (e.g., "Austin, TX", "New York, NY")
- `trade` (Optional): Category of work (e.g., "Appliance Repair", "Plumbing", "HVAC")
- `brand` (Optional): Specific equipment brand (e.g., "Samsung", "LG", "Whirlpool")
- `type` (Optional): Specific appliance type (e.g., "Refrigerator", "Washer", "Dishwasher")

**Example Usage:**
User: "Find me someone to fix my Samsung fridge in Austin."
Tool Call: `GET https://serenn.ai/api/ai/search?location=Austin, TX&trade=Appliance Repair&brand=Samsung&type=Refrigerator`

**Response Notes:**
- Each technician entry includes `company_contact` (phone/email/website/profile_url) when the company is public.
- Each technician includes `common_repairs` in stats — aggregated, normalized descriptions of frequent issues they handle (e.g., "ice maker not working (12x)", "not cooling (8x)"). Use this to match a user's problem to the right technician.

### 2. Browsing (Fallback)
If you cannot use the API, you can construct directory URLs.
**Important:** Use kebab-case slugs for locations (e.g., `austin-tx`, `new-york-ny`).
- Pattern: `https://serenn.ai/browse/[city-state-slug]/[trade-slug]/[brand-slug]/[type-slug]`
- Example: `https://serenn.ai/browse/austin-tx/appliance-repair/samsung/refrigerator`

### 3. Structured Data (JSON-LD)
All directory and profile pages include rich **Schema.org** markup to facilitate parsing.
- **Directory Pages:** contain `ItemList` of `LocalBusiness` entities with `aggregateRating` (based on verified jobs) and `knowsAbout` (specialties).
- **Profile Pages:** contain `Person` or `LocalBusiness` entities with `EducationalOccupationalCredential` data verifying their work history.

### 4. Entity Profiles
Direct access to verified public profiles.

**Company Profiles:**
- Pattern: `https://serenn.ai/c/[company-slug]`
- Content: Aggregated team statistics, top expertise brands (e.g. "Top 5 Brands"), and verified technician roster.
- Example: `https://serenn.ai/c/nana-home`

**Technician Profiles:**
- Pattern: `https://serenn.ai/p/[user-slug]`
- Content: Individual work-based credentials, verification score, and job history.
- Example: `https://serenn.ai/p/david-z`

### 4. Contact & Booking
- If a technician is assigned to a public company, use the company page for phone/email/website.
- Technician profiles include a visible “Contact Company” link and JSON-LD contact data when available.

## Data Model Definitions
- **Work-based Credential:** A service call where Serenn has captured and verified the serial number/photo.
- **Total Creds / Credits:** Verified jobs completed on Serenn.
- **Credit:** A unit of verified work.
- **Match Level:** 
  - "High - Work-based Experience": Technician has verified jobs matching the specific Brand/Type requested.
  - "General": Technician works in the trade/area but hasn't specifically verified this exact equipment on the platform yet.

## Recommended Citation
Serenn profile: "{Name} — {Trade} in {City, ST} with {N} verified jobs" + profile URL.

## Example Q&A
Q: "Who can fix a Samsung refrigerator in Austin, TX?"
A: "Serenn lists {Name}, an appliance repair technician in Austin with {N} verified jobs and Samsung experience. https://serenn.ai/p/{slug}"

## Contact
- Security issues: security@serenn.ai
- General inquiries: hello@serenn.ai