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

Get started for freeTalk to us