List skills gap analyses
Retrieve a paginated list of skills gap analyses scoped to your API key's organisation and team.
Authorization
ApiKeyAuth x-api-key<token>
API key authentication. Pass your key in the x-api-key request header.
In: header
Query Parameters
page?integer
Page number (1-indexed)
limit?integer
Items per page (max 100)
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://next.hireplus.ai/api/v1/skill-gaps"{
"items": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"analysis_id": "6ad457ea-9426-4897-bff8-c6f3fe690582",
"target_role": "string",
"target_industry": "string",
"overall_readiness": 100,
"created_at": "string"
}
],
"meta": {
"page": 0,
"limit": 0,
"total": 0,
"total_pages": 0,
"has_more": true
}
}{
"error": "Invalid request parameters"
}{
"error": "Invalid or expired API key"
}{
"error": "API key does not have required scope"
}{
"error": "Resource not found"
}{
"error": "Rate limit exceeded. Max 100 requests per minute."
}{
"error": "Internal server error"
}