Retrieves a single employee record by UUID from the local employee service.
\nEndpointGET http://localhost:8080/api/v1/employee/{uuid}
Path Parameter
\nuuid — The unique identifier of the employee to retrieve. Example: 550e8400-e29b-41d4-a716-446655440001Request Behavior
Send a GET request to the endpoint with the target employee's UUID in the path. The service returns one employee object corresponding to the supplied identifier.
Successful Response
\n200 OK — Returns a single employee object.Returned Fields
Based on the sample response, the returned object includes:
uuid — Employee UUID.firstName — Employee first name.lastName — Employee last name.fullName — Full name for the employee.salary — Employee salary.age — Employee age.jobTitle — Employee job title.email — Employee email address.contractHireDate — Contract start or hire date.contractTerminationDate — Contract termination date.Practical Notes
\n{uuid} in the endpoint path with a valid employee UUID before sending the request.Retrieves all employee records.
\nMethod: GET
Path: /api/v1/employee
URL: http://localhost:8080/api/v1/employee
Sends a GET request to the employee collection endpoint and returns the available employee records.
No request body is sent.
\nNo query parameters are currently configured on this request.
\nNo request headers are explicitly configured on this request.
\nA successful response returns HTTP 200 OK with a JSON array of employee objects.
\nEach item in the array represents one employee record.
\nBased on the sample response, employee objects may include:
\nuuid — Unique identifier for the employee.
firstName — Employee's first name.
lastName — Employee's last name.
fullName — Full display name for the employee.
salary — Employee salary value; sample values indicate a numeric type.
age — Employee age; sample values indicate a numeric type.
jobTitle — Employee job title or role.
email — Employee email address.
contractHireDate — Contract start date/time represented as an ISO-8601 datetime string in the sample response.
contractTerminationDate — Contract termination date/time when available; this field may be null in the sample response.
This request is intended for listing employee records rather than retrieving a single employee.
\nThe response body is an array, so client code should be prepared to handle zero or more employee objects.
\nField availability and nullability should be handled defensively, especially for optional values such as contractTerminationDate.
Creates a new employee record.
\nCreates a new employee resource by submitting the employee's core profile and contract details in the request body.
\nMethod: POST
URL: http://localhost:8080/api/v1/employee
Send a JSON object with the following fields:
\nfirstName (string): Employee's first name.
lastName (string): Employee's last name.
fullName (string): Employee's full name.
salary (number): Employee salary amount.
age (number): Employee age.
jobTitle (string): Employee's role or job title.
email (string): Employee email address.
contractHireDate (string, ISO 8601 datetime): Contract start date and time.
contractTerminationDate (string | null, ISO 8601 datetime): Contract end date and time, or null when not set.
{\n \"firstName\": \"Emily\",\n \"lastName\": \"Brown\",\n \"fullName\": \"Emily Brown\",\n \"salary\": 70000,\n \"age\": 26,\n \"jobTitle\": \"Business Analyst\",\n \"email\": \"emily.brown@example.com\",\n \"contractHireDate\": \"2025-02-03T10:15:00Z\",\n \"contractTerminationDate\": null\n}\n\nA successful request returns 200 OK and includes the created employee object.
uuid (string): Generated unique identifier for the employee.
firstName (string): Employee's first name.
lastName (string): Employee's last name.
fullName (string): Employee's full name.
salary (number): Employee salary amount.
age (number): Employee age.
jobTitle (string): Employee's role or job title.
email (string): Employee email address.
contractHireDate (string, ISO 8601 datetime): Contract start date and time.
contractTerminationDate (string | null, ISO 8601 datetime): Contract end date and time, or null if not set.
This request is used to add a new employee record to the system.
\nThe response mirrors the submitted employee data and adds a generated uuid.
contractTerminationDate may be null for employees without an end date defined at creation time.