Skip to main content

Guide Expertise Areas API

The Guide Expertise Areas API provides access to expertise categories that guides can select to showcase their specializations. Expertise areas help tourists find guides with the right skills and knowledge for their desired experiences.

Base Endpoint

/api/guide_expertise_areas

Guide Expertise Area Model

expertiseId
integer
required
Unique identifier for the expertise area category
name
string
required
Name of the expertise area (e.g., “Archaeological Sites”, “Adventure Sports”, “Local Cuisine”)

Create Expertise Area

Create a new expertise area category.
POST /api/guide_expertise_areas

Request Body

name
string
required
Name of the expertise area

Example Request

curl -X POST "http://localhost:8080/api/guide_expertise_areas" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Archaeological Sites"
  }'

Example Response

{
  "expertiseId": 1,
  "name": "Archaeological Sites"
}

Get All Expertise Areas

Retrieve all available expertise area categories.
GET /api/guide_expertise_areas

Example Request

curl -X GET "http://localhost:8080/api/guide_expertise_areas"

Example Response

[
  {
    "expertiseId": 1,
    "name": "Archaeological Sites"
  },
  {
    "expertiseId": 2,
    "name": "Adventure Sports"
  },
  {
    "expertiseId": 3,
    "name": "Local Cuisine"
  },
  {
    "expertiseId": 4,
    "name": "Wildlife & Nature"
  },
  {
    "expertiseId": 5,
    "name": "Cultural Heritage"
  }
]

Get Expertise Area by ID

Retrieve a specific expertise area by ID.
GET /api/guide_expertise_areas/{id}

Path Parameters

id
integer
required
Expertise area ID

Example Request

curl -X GET "http://localhost:8080/api/guide_expertise_areas/1"

Example Response

{
  "expertiseId": 1,
  "name": "Archaeological Sites"
}

Update Expertise Area

Update an existing expertise area category.
PUT /api/guide_expertise_areas/{id}

Path Parameters

id
integer
required
Expertise area ID

Request Body

name
string
required
Updated name of the expertise area

Example Request

curl -X PUT "http://localhost:8080/api/guide_expertise_areas/1" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mayan Archaeological Sites"
  }'

Example Response

{
  "expertiseId": 1,
  "name": "Mayan Archaeological Sites"
}

Delete Expertise Area

Delete an expertise area category by ID.
DELETE /api/guide_expertise_areas/{id}

Path Parameters

id
integer
required
Expertise area ID

Example Request

curl -X DELETE "http://localhost:8080/api/guide_expertise_areas/1"

Example Response

204 No Content

Common Expertise Areas

Here are typical expertise areas used in the Kin Conecta platform:
Expertise AreaDescription
Archaeological SitesMayan ruins, Aztec temples, ancient civilizations
Adventure SportsRock climbing, rappelling, zip-lining, extreme sports
Local CuisineTraditional food, cooking techniques, culinary history
Wildlife & NatureFlora and fauna identification, eco-tourism, conservation
Cultural HeritageTraditional crafts, indigenous communities, folklore
Historical ArchitectureColonial buildings, religious sites, architectural styles
Marine BiologyCoral reefs, sea life, snorkeling/diving guides
PhotographyLandscape photography, cultural photography techniques
Artisan CraftsTraditional textiles, pottery, jewelry making
Wine & SpiritsMezcal, tequila, wine regions, distillery tours
Urban ExplorationStreet art, neighborhoods, modern culture
Wellness & SpiritualityTraditional medicine, spiritual practices, ceremonies

Guide Profiles

Manage guide profiles that use expertise areas

Guide Profile Expertise

Associate expertise areas with guide profiles

Build docs developers (and LLMs) love