Network Rail Jobs

Get Jobs

Verb: GET
Endpoint: /api/v2/jobs
Request:
- - city: String, filter jobs by city.
  - department: String, filter jobs by department.
  - status: String, filter jobs by status.
  - type: String, filter jobs by type.
  - from: String, filter jobs by start date.
  - to: String, filter jobs by end date.

Response:

     {
         success: Boolean,
         jobsCount: Number,
         filterBy: Object,
         jobs: [
             {
                 location: {
                     city: String,
                     postcode: String,
                     lat: Number,
                     lng: Number
                 },
                 salary: {
                     min: Number | null,
                     max: Number | null
                 },
                 dates: {
                     start: String,
                     end: String
                 },
                 _id: MongoDB ObjectId,
                 jobId: String,
                 title: String,
                 description: String,
                 department: String,
                 status: String,
                 type: String,
                 applyLink: String,
                 __v: Number
             },
             ...
         ]
     }

Get Cities

Verb: GET
Endpoint: /api/v2/jobs/cities
Request: none
Response:
```
[String]
```

Get Job Statuses

Verb: GET
Endpoint: /api/v2/jobs/statuses
Request: none
Response:
```
[String]
```

Get Job Types

Verb: GET
Endpoint: /api/v2/jobs/types
Request: none
Response:
```
[String]
```

Get Departments

Verb: GET
Endpoint: /api/v2/jobs/departments
Request: none
Response:
```
[String]
```

Get Job by ID

Verb: GET
Endpoint: /api/v2/job/:id
Path Parameters:
- id: MongoDB ObjectId, the unique identifier of the job.

Responses:

200: OK

     {
         success: Boolean,
         job: {
             location: {
                 city: String,
                 postcode: String,
                 lat: Number,
                 lng: Number
             },
             salary: {
                 min: Number | null,
                 max: Number | null
             },
             dates: {
                 start: String,
                 end: String
             },
             _id: MongoDB ObjectId,
             jobId: String,
             title: String,
             description: String,
             department: String,
             status: String,
             type: String,
             applyLink: String,
             __v: Number
         }
     }

404: Error
```
[String]
```