Skip to main content

​
Overview

The Guide Certifications API manages professional certifications, licenses, and credentials that guides hold. These certifications build trust and credibility with tourists by showcasing professional qualifications.

​
Base URL

/api/guide_certifications

​
Create Certification

Add a new certification to a guide’s profile. 
curl -X POST "https://api.kinconecta.com/api/guide_certifications" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "guideProfileId": 123,
    "name": "Certified Tour Guide",
    "issuingOrganization": "National Tourism Board",
    "issueDate": "2023-01-15",
    "expirationDate": "2025-01-15",
    "credentialId": "CTG-2023-12345",
    "credentialUrl": "https://tourism.gov/verify/CTG-2023-12345"
  }'

​
Request Body

​
guideProfileId
Long
required
ID of the guide profile this certification belongs to
​
name
String
required
Name of the certification (e.g., “Certified Tour Guide”, “First Aid Certified”)
​
issuingOrganization
String
required
Organization that issued the certification
​
issueDate
Date
required
Date when the certification was issued (YYYY-MM-DD)
​
expirationDate
Date
Expiration date if applicable (YYYY-MM-DD)
​
credentialId
String
Unique credential or license number
​
credentialUrl
String
URL to verify the certification online

​
Response

Returns the created certification with generated ID. 
{
  "id": 456,
  "guideProfileId": 123,
  "name": "Certified Tour Guide",
  "issuingOrganization": "National Tourism Board",
  "issueDate": "2023-01-15",
  "expirationDate": "2025-01-15",
  "credentialId": "CTG-2023-12345",
  "credentialUrl": "https://tourism.gov/verify/CTG-2023-12345",
  "createdAt": "2024-03-10T15:30:00Z",
  "updatedAt": "2024-03-10T15:30:00Z"
}

​
Get All Certifications

Retrieve all certifications across all guides (admin use). 
curl -X GET "https://api.kinconecta.com/api/guide_certifications" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response

Returns an array of all certification records.

​
Get Certification by ID

Retrieve a specific certification. 
curl -X GET "https://api.kinconecta.com/api/guide_certifications/{id}" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Path Parameters

​
id
Long
required
The ID of the certification

​
Response

Returns a single certification object.

​
Update Certification

Update an existing certification. 
curl -X PUT "https://api.kinconecta.com/api/guide_certifications/{id}" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Advanced Certified Tour Guide",
    "expirationDate": "2026-01-15"
  }'

​
Path Parameters

​
id
Long
required
The ID of the certification to update

​
Request Body

Same fields as create, all optional. Only include fields you want to update.

​
Response

Returns the updated certification object.

​
Delete Certification

Remove a certification from a guide’s profile. 
curl -X DELETE "https://api.kinconecta.com/api/guide_certifications/{id}" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Path Parameters

​
id
Long
required
The ID of the certification to delete

​
Response

Returns 204 No Content on success.

​
Common Certification Types

  • Certified Tour Guide
  • Licensed Travel Specialist
  • Cultural Heritage Interpreter
  • National Park Ranger Certification
  • First Aid Certified
  • CPR Certified
  • Wilderness First Responder
  • Water Safety Instructor
  • DELE Spanish Certification
  • TOEFL English Proficiency
  • Cultural Competency Certification
  • Indigenous Language Certification
  • Scuba Diving Instructor (PADI/SSI)
  • Rock Climbing Instructor
  • Culinary Arts Certification
  • Photography Workshop Leader

​
Best Practices

Verification Matters: Always provide credential IDs and verification URLs when possible. This helps build trust with tourists.
Keep Current: Set expiration date reminders and renew certifications before they expire to maintain verified status.
Accurate Information: Only add certifications you actually hold. False certifications violate terms of service and can result in account suspension.

Build docs developers (and LLMs) love

Get started for freeTalk to us