Quinyx Employee API
The Employee API from Quinyx — 2 operation(s) for employee.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/quinyx-employee-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Quinyx Employee API
version: v3
x-service: dummy
description: null
servers:
- url: https://api.{region}.quinyx.com
description: Production
variables:
region:
default: eu
enum:
- eu
- na
- url: https://api.{region}.rc.quinyx.com
description: RC
variables:
region:
default: eu
enum:
- eu
- na
tags:
- name: Employee
paths:
/hr/v3/employees/{id}:
get:
tags:
- Employee
summary: Get an employee
description: Retrieves a single employee by its identifier.
operationId: getEmployee
parameters:
- name: id
in: path
description: Employee identifier
required: true
schema:
description: An identifier that can be either a Quinyx ID or a prefixed external ID string.
oneOf:
- type: string
description: The Quinyx ID of the resource.
pattern: ^[0-9]+$
- type: string
description: The external string ID, which must start with 'badgeNumber:'.
example: badgeNumber:1234
pattern: ^badgeNumber:[a-zA-Z0-9._-]{1,64}$
examples:
internal-id:
summary: Internal ID
description: The internal ID of the resource
value: '12345'
badge-number:
summary: Badge number
description: Badge number prefixed with 'badgeNumber:', 1-64 characters long, consisting of alphanumerics and . _ -
value: badgeNumber:B001
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/employee_IntegrationEmployeeResponse'
'400':
description: Bad Request
content:
application/problem+json:
schema:
oneOf:
- $ref: '#/components/schemas/employee_ProblemDetail'
- $ref: '#/components/schemas/employee_ValidationError'
examples:
badRequestProblemDetail:
summary: Bad request
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/bad-request
title: Bad Request
status: 400
detail: The request is invalid or malformed
instance: /hr/v3/employees/{id}
badRequestValidationError:
summary: Bad request
description: Example ValidationError response
value:
type: https://developer.quinyx.com/api/problems/bad-request
title: Bad Request
status: 400
errors:
- detail: name is mandatory
pointer: '#/name'
instance: /hr/v3/employees/{id}
'401':
description: Unauthorized
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
unauthorized:
summary: Unauthorized
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/unauthorized
title: Unauthorized
status: 401
detail: Access token not set or invalid, and the requested resource could not be returned
instance: /hr/v3/employees/{id}
'403':
description: Forbidden
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
forbidden:
summary: Forbidden
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/forbidden
title: Forbidden
status: 403
detail: The resource could not be returned as the requestor is not authorized
instance: /hr/v3/employees/{id}
'404':
description: Not Found
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
notFound:
summary: Not found
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/not-found
title: Not Found
status: 404
detail: The requested resource was not found
instance: /hr/v3/employees/{id}
'500':
description: Server Error
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
serverError:
summary: Server error
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/server-error
title: Server Error
status: 500
detail: The server encountered an unexpected error
instance: /hr/v3/employees/{id}
security:
- OAuth2ClientCredentials:
- hr:employees:read
x-audience: public
x-resource-group: HR
x-resource: Employee
put:
tags:
- Employee
summary: Update an employee
description: Updates the specified employee with the provided attributes and returns it
operationId: updateEmployee
parameters:
- name: id
in: path
description: Employee identifier
required: true
schema:
description: An identifier that can be either a Quinyx ID or a prefixed external ID string.
oneOf:
- type: string
description: The Quinyx ID of the resource.
pattern: ^[0-9]+$
- type: string
description: The external string ID, which must start with 'badgeNumber:'.
example: badgeNumber:1234
pattern: ^badgeNumber:[a-zA-Z0-9._-]{1,64}$
examples:
internal-id:
summary: Internal ID
description: The internal ID of the resource
value: '12345'
badge-number:
summary: Badge number
description: Badge number prefixed with 'badgeNumber:', 1-64 characters long, consisting of alphanumerics and . _ -
value: badgeNumber:B001
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/employee_IntegrationEmployeeUpdateRequest'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/employee_IntegrationEmployeeResponse'
'400':
description: Bad Request
content:
application/problem+json:
schema:
oneOf:
- $ref: '#/components/schemas/employee_ProblemDetail'
- $ref: '#/components/schemas/employee_ValidationError'
examples:
badRequestProblemDetail:
summary: Bad request
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/bad-request
title: Bad Request
status: 400
detail: The request is invalid or malformed
instance: /hr/v3/employees/{id}
badRequestValidationError:
summary: Bad request
description: Example ValidationError response
value:
type: https://developer.quinyx.com/api/problems/bad-request
title: Bad Request
status: 400
errors:
- detail: name is mandatory
pointer: '#/name'
instance: /hr/v3/employees/{id}
'401':
description: Unauthorized
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
unauthorized:
summary: Unauthorized
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/unauthorized
title: Unauthorized
status: 401
detail: Access token not set or invalid, and the requested resource could not be returned
instance: /hr/v3/employees/{id}
'403':
description: Forbidden
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
forbidden:
summary: Forbidden
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/forbidden
title: Forbidden
status: 403
detail: The resource could not be returned as the requestor is not authorized
instance: /hr/v3/employees/{id}
'404':
description: Not Found
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
notFound:
summary: Not found
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/not-found
title: Not Found
status: 404
detail: The requested resource was not found
instance: /hr/v3/employees/{id}
'500':
description: Server Error
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
serverError:
summary: Server error
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/server-error
title: Server Error
status: 500
detail: The server encountered an unexpected error
instance: /hr/v3/employees/{id}
security:
- OAuth2ClientCredentials:
- hr:employees:update
x-audience: public
x-resource-group: HR
x-resource: Employee
delete:
tags:
- Employee
summary: Delete an employee
description: Permanently deletes an employee
operationId: deleteEmployee
parameters:
- name: id
in: path
description: Employee identifier
required: true
schema:
description: An identifier that can be either a Quinyx ID or a prefixed external ID string.
oneOf:
- type: string
description: The Quinyx ID of the resource.
pattern: ^[0-9]+$
- type: string
description: The external string ID, which must start with 'badgeNumber:'.
example: badgeNumber:1234
pattern: ^badgeNumber:[a-zA-Z0-9._-]{1,64}$
examples:
internal-id:
summary: Internal ID
description: The internal ID of the resource
value: '12345'
badge-number:
summary: Badge number
description: Badge number prefixed with 'badgeNumber:', 1-64 characters long, consisting of alphanumerics and . _ -
value: badgeNumber:B001
responses:
'200':
description: OK
'401':
description: Unauthorized
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
unauthorized:
summary: Unauthorized
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/unauthorized
title: Unauthorized
status: 401
detail: Access token not set or invalid, and the requested resource could not be returned
instance: /hr/v3/employees/{id}
'403':
description: Forbidden
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
forbidden:
summary: Forbidden
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/forbidden
title: Forbidden
status: 403
detail: The resource could not be returned as the requestor is not authorized
instance: /hr/v3/employees/{id}
'404':
description: Not Found
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
notFound:
summary: Not found
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/not-found
title: Not Found
status: 404
detail: The requested resource was not found
instance: /hr/v3/employees/{id}
'500':
description: Server Error
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
serverError:
summary: Server error
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/server-error
title: Server Error
status: 500
detail: The server encountered an unexpected error
instance: /hr/v3/employees/{id}
security:
- OAuth2ClientCredentials:
- hr:employees:delete
x-audience: public
x-resource-group: HR
x-resource: Employee
patch:
tags:
- Employee
summary: Partially update an employee
description: Partially updates the specified employee with the provided attributes and returns it.
operationId: patchEmployee
parameters:
- name: id
in: path
description: Employee identifier
required: true
schema:
description: An identifier that can be either a Quinyx ID or a prefixed external ID string.
oneOf:
- type: string
description: The Quinyx ID of the resource.
pattern: ^[0-9]+$
- type: string
description: The external string ID, which must start with 'badgeNumber:'.
example: badgeNumber:1234
pattern: ^badgeNumber:[a-zA-Z0-9._-]{1,64}$
examples:
internal-id:
summary: Internal ID
description: The internal ID of the resource
value: '12345'
badge-number:
summary: Badge number
description: Badge number prefixed with 'badgeNumber:', 1-64 characters long, consisting of alphanumerics and . _ -
value: badgeNumber:B001
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/employee_IntegrationEmployeePatchRequest'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/employee_IntegrationEmployeeResponse'
'400':
description: Bad Request
content:
application/problem+json:
schema:
oneOf:
- $ref: '#/components/schemas/employee_ProblemDetail'
- $ref: '#/components/schemas/employee_ValidationError'
examples:
badRequestProblemDetail:
summary: Bad request
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/bad-request
title: Bad Request
status: 400
detail: The request is invalid or malformed
instance: /hr/v3/employees/{id}
badRequestValidationError:
summary: Bad request
description: Example ValidationError response
value:
type: https://developer.quinyx.com/api/problems/bad-request
title: Bad Request
status: 400
errors:
- detail: name is mandatory
pointer: '#/name'
instance: /hr/v3/employees/{id}
'401':
description: Unauthorized
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
unauthorized:
summary: Unauthorized
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/unauthorized
title: Unauthorized
status: 401
detail: Access token not set or invalid, and the requested resource could not be returned
instance: /hr/v3/employees/{id}
'403':
description: Forbidden
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
forbidden:
summary: Forbidden
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/forbidden
title: Forbidden
status: 403
detail: The resource could not be returned as the requestor is not authorized
instance: /hr/v3/employees/{id}
'404':
description: Not Found
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
notFound:
summary: Not found
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/not-found
title: Not Found
status: 404
detail: The requested resource was not found
instance: /hr/v3/employees/{id}
'500':
description: Server Error
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
serverError:
summary: Server error
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/server-error
title: Server Error
status: 500
detail: The server encountered an unexpected error
instance: /hr/v3/employees/{id}
security:
- OAuth2ClientCredentials:
- hr:employees:update
x-audience: public
x-resource-group: HR
x-resource: Employee
/hr/v3/employees:
get:
tags:
- Employee
summary: List employees
description: Returns a paginated list of employees.
operationId: getEmployees
parameters:
- name: idIn
in: query
required: false
schema:
type: array
items:
type: integer
format: int32
maxItems: 50
- name: pageToken
in: query
description: Cursor for the next page of results.
required: false
schema:
type: string
example: eyJpZCI6MTAwfQ
- name: pageSize
in: query
description: Maximum number of items to return.
required: false
schema:
type: integer
format: int32
default: 50
example: 50
maximum: 100
minimum: 1
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/employee_CursorPageIntegrationEmployeeResponse'
'400':
description: Bad Request
content:
application/problem+json:
schema:
oneOf:
- $ref: '#/components/schemas/employee_ProblemDetail'
- $ref: '#/components/schemas/employee_ValidationError'
examples:
badRequestProblemDetail:
summary: Bad request
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/bad-request
title: Bad Request
status: 400
detail: The request is invalid or malformed
instance: /hr/v3/employees
badRequestValidationError:
summary: Bad request
description: Example ValidationError response
value:
type: https://developer.quinyx.com/api/problems/bad-request
title: Bad Request
status: 400
errors:
- detail: name is mandatory
pointer: '#/name'
instance: /hr/v3/employees
'401':
description: Unauthorized
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
unauthorized:
summary: Unauthorized
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/unauthorized
title: Unauthorized
status: 401
detail: Access token not set or invalid, and the requested resource could not be returned
instance: /hr/v3/employees
'403':
description: Forbidden
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
forbidden:
summary: Forbidden
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/forbidden
title: Forbidden
status: 403
detail: The resource could not be returned as the requestor is not authorized
instance: /hr/v3/employees
'500':
description: Server Error
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
serverError:
summary: Server error
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/server-error
title: Server Error
status: 500
detail: The server encountered an unexpected error
instance: /hr/v3/employees
security:
- OAuth2ClientCredentials:
- hr:employees:read
x-audience: public
x-resource-group: HR
x-resource: Employee
post:
tags:
- Employee
summary: Create an employee
description: Creates and returns the created employee.
operationId: createEmployee
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/employee_IntegrationEmployeeCreateRequest'
required: true
responses:
'201':
description: Created
content:
application/json:
schema:
$ref: '#/components/schemas/employee_IntegrationEmployeeResponse'
'400':
description: Bad Request
content:
application/problem+json:
schema:
oneOf:
- $ref: '#/components/schemas/employee_ProblemDetail'
- $ref: '#/components/schemas/employee_ValidationError'
examples:
badRequestProblemDetail:
summary: Bad request
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/bad-request
title: Bad Request
status: 400
detail: The request is invalid or malformed
instance: /hr/v3/employees
badRequestValidationError:
summary: Bad request
description: Example ValidationError response
value:
type: https://developer.quinyx.com/api/problems/bad-request
title: Bad Request
status: 400
errors:
- detail: name is mandatory
pointer: '#/name'
instance: /hr/v3/employees
'401':
description: Unauthorized
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
unauthorized:
summary: Unauthorized
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/unauthorized
title: Unauthorized
status: 401
detail: Access token not set or invalid, and the requested resource could not be returned
instance: /hr/v3/employees
'403':
description: Forbidden
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
forbidden:
summary: Forbidden
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/forbidden
title: Forbidden
status: 403
detail: The resource could not be returned as the requestor is not authorized
instance: /hr/v3/employees
'500':
description: Server Error
content:
application/problem+json:
schema:
$ref: '#/components/schemas/employee_ProblemDetail'
examples:
serverError:
summary: Server error
description: Example ProblemDetail response
value:
type: https://developer.quinyx.com/api/problems/server-error
title: Server Error
status: 500
detail: The server encountered an unexpected error
instance: /hr/v3/employees
security:
- OAuth2ClientCredentials:
- hr:employees:create
x-audience: public
x-resource-group: HR
x-resource: Employee
components:
schemas:
employee_Employment:
type: object
properties:
homeGroupId:
type: string
description: ID of the employee's home group
example: '123'
staffCategoryId:
type: string
description: ID of the staff category assigned to the employee
example: '123'
passive:
type: boolean
description: Whether the employee is passive
example: false
locked:
type: string
description: Lock status of the employee account
enum:
- NOT_LOCKED
- LOCKED_BY_MANAGER
- LOCKED_BY_SYSTEM
example: NOT_LOCKED
employmentStartDate:
type: string
format: date
description: Date when the employment started
example: '2020-01-01'
industryStartDate:
type: string
format: date
description: Date when the employee started working in the industry
example: '2015-01-01'
managerId:
type: string
description: ID of the employee's manager
example: '1234'
employmentEndDate:
type: string
format: date
description: Date when the employment ends, if applicable
example: '2025-12-31'
costCentreId:
type: string
description: Cost centre ID
example: '1234'
employee_UpdateEmergencyContact:
type: object
properties:
nextOfKinName:
type: string
description: Name of the employee's next of kin
example: John Doe
maxLength: 50
minLength: 0
nextOfKinPhone:
type: string
description: Phone number of the employee's next of kin
example: '+46700000000'
maxLength: 20
minLength: 0
legalGuardianName:
type: string
description: Name of the employee's legal guardian
example: Jane Doe
maxLength: 50
minLength: 0
legalGuardianEmail:
type: string
description: Email address of the employee's legal guardian
example: guardian@example.com
maxLength: 50
minLength: 0
required:
- legalGuardianEmail
- legalGuardianName
- nextOfKinName
- nextOfKinPhone
employee_EmergencyContact:
type: object
properties:
nextOfKinName:
type: string
description: Name of the employee's next of kin
example: John Doe
maxLength: 50
minLength: 0
nextOfKinPhone:
type: string
description: Phone number of the employee's next of kin
example: '+46700000000'
maxLength: 20
minLength: 0
legalGuardianName:
type: string
description: Name of the employee's legal guardian
example: Jane Doe
maxLength: 50
minLength: 0
legalGuardianEmail:
type: string
description: Email address of the employee's legal guardian
example: guardian@example.com
maxLength: 50
minLength: 0
employee_UpdatePersonalInformation:
type: object
properties:
fir
# --- truncated at 32 KB (50 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/quinyx/refs/heads/main/openapi/quinyx-employee-api-openapi.yml