Welcome to the Koios API! Our API enables seamless integration of advanced talent and sales assessments into your applications. Built with scalability and precision in mind, Koios empowers businesses to deliver personalised experiences by leveraging the Big 5 personality framework and proprietary insights.
Key Features:
Core Assessments: Submit and track core assessments without insights.
Sales Assessments: Evaluate sales acumen through voice-based interactions.
Talent Assessments: Unlock potential by analysing talent attributes.
Personalised Insights: Access personality and behavioural insights based on the Big 5 framework.
Seamless Integration: API-first design for ease of use and scalability.
Sales Assessments: Evaluate sales acumen through voice-based interactions.
Talent Assessments: Unlock potential by analysing talent attributes.
Personalised Insights: Access personality and behavioural insights based on the Big 5 framework.
Seamless Integration: API-first design for ease of use and scalability.
Endpoints Overview:
Submit Core Assessment
Endpoint: POST /api/assessments/coreDescription: Upload audio files for core assessments.
Required Fields:
- audio (binary): The audio file for the assessment.
- name (string): The name associated with the assessment.
- name (string): The name associated with the assessment.
Response Example:
{
"assessment_id": "12345",
"status": "processing"
}Submit Sales Assessment
Endpoint: POST /api/assessments/salesDescription: Evaluate sales professionals using audio inputs
Required Fields:
- audio (binary): The audio file for the assessment.
- name (string): The name associated with the assessment.
- name (string): The name associated with the assessment.
Response Example:
{
"assessment_id": "12345",
"status": "processing"
}Get Assessment Details:
Endpoint: GET /api/assessments/{assessment_id}Description: Retrieve assessment details, including Big 5 personality results, communication
insights, and business value metrics.
insights, and business value metrics.
Path Parameter:
Assessment_id (string): The ID of the assessment.
Response Example:
{
"assessment_id": "12345",
"name": "John Doe",
"status": "completed",
"agreeableness": "High",
"conscientiousness": "Mid",
"insights": {
"communication": {
"summary": "Clear and concise communicator.",
"best": ["Empathetic", "Structured"],
"worst": ["Verbose"]
}
}
}Pricing
Our pricing is straightforward and pay-as-you-go:
Our pricing is straightforward and pay-as-you-go:
- Koios Core: Big 5 prediction that delivers 5 scores - £0.15 per API call
- Koios Talent: Big 5 prediction and Talent Insights - £0.35 per API call
- Koios Sales: Big 5 prediction and Sales Insights - £0.40 per API call
- Koios Talent: Big 5 prediction and Talent Insights - £0.35 per API call
- Koios Sales: Big 5 prediction and Sales Insights - £0.40 per API call
Security
Our API uses JWT bearer authentication. To access the API, include a valid token in the
Authorization header:
Authorization: Bearer <your_token>
Authorization: Bearer <your_token>
Getting Started
1. Generate an API Key: Contact our support team to request access.
2. Review the Documentation: Familiarise yourself with the endpoints and their requirements.
3. Integrate and Test: Use tools like Postman or your preferred environment to test the API.
1. Generate an API Key: Contact our support team to request access.
2. Review the Documentation: Familiarise yourself with the endpoints and their requirements.
3. Integrate and Test: Use tools like Postman or your preferred environment to test the API.
Need Help?
Visit our Support Page or reach out to our team at support@koios.ai.
Visit our Support Page or reach out to our team at support@koios.ai.