RMS Services API Reference (1.0.1)

Download OpenAPI specification:Download

This document provides a comprehensive reference guide for the RMS Services API. The RMS Services API is a set of RESTful endpoints that allow developers to programmatically interact with RMS Services. This document includes detailed descriptions of each available endpoint, as well as the parameters, methods, and data structures used by the API.

Copyright: © Keture 2023. All rights reserved. This API reference is provided solely for the purpose of development and testing. Any commercial use or redistribution of this API, or any part thereof, is strictly prohibited without the prior written consent of Keture.

Admin

Admin related end-points

/api/v1/admin/department

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/admin/department/

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
name
required
string

Responses

Request samples

Content type
application/json
{
  • "name": "Sales"
}

/api/v1/admin/department/

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
id
required
integer
name
required
string

Responses

Request samples

Content type
application/json
{
  • "id": 123,
  • "name": "Engneering"
}

/api/v1/admin/department/

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
id
required
integer

Responses

Request samples

Content type
application/json
{
  • "id": 123
}

/api/v1/admin/department/{id}

Authorizations:
bearerAuth
path Parameters
id
required
any
v1
required
string
Default: "v1"

Responses

/api/v1/admin/job_type

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/admin/job_type/

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
name
required
string
description
string

Responses

Request samples

Content type
application/json
{
  • "name": "Full-time",
  • "description": "A full-time permanent job."
}

Response samples

Content type
application/json
{
  • "id": 123,
  • "name": "Full-time",
  • "description": "A full-time permanent job."
}

/api/v1/admin/job_type/

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
id
required
integer
name
required
string
description
string

Responses

Request samples

Content type
application/json
{
  • "id": 123,
  • "name": "Part-time",
  • "description": "A part-time temporary job."
}

Response samples

Content type
application/json
{
  • "id": 123,
  • "name": "Part-time",
  • "description": "A part-time temporary job."
}

/api/v1/admin/job_type/

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
id
required
integer

Responses

Request samples

Content type
application/json
{
  • "id": 123
}

Response samples

Content type
application/json
{
  • "message": "Job type with id 123 was deleted successfully"
}

/api/v1/admin/job_type/{id}

Authorizations:
bearerAuth
path Parameters
id
required
any
v1
required
string
Default: "v1"

Responses

/api/v1/admin/work_style

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/admin/work_style/

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
name
required
string
description
string

Responses

Request samples

Content type
application/json
{
  • "name": "Remote",
  • "description": "Ability to work remotely."
}

Response samples

Content type
application/json
{
  • "id": 123,
  • "name": "Remote",
  • "description": "Ability to work remotely."
}

/api/v1/admin/work_style/

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
id
required
integer
name
required
string
description
string

Responses

Request samples

Content type
application/json
{
  • "id": 123,
  • "name": "Hybrid",
  • "description": "Combination of office and remote work."
}

Response samples

Content type
application/json
{
  • "id": 123,
  • "name": "Hybrid",
  • "description": "Combination of office and remote work."
}

/api/v1/admin/work_style/

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
id
required
integer

Responses

Request samples

Content type
application/json
{
  • "id": "123"
}

Response samples

Content type
application/json
{
  • "message": "Work style with id 123 was deleted successfully"
}

/api/v1/admin/work_style/{id}

Authorizations:
bearerAuth
path Parameters
id
required
any
v1
required
string
Default: "v1"

Responses

/api/v1/admin/job_level

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/admin/job_level/

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
name
required
string
description
string

Responses

Request samples

Content type
application/json
{
  • "name": "Entry",
  • "description": "Beginner or junior level job."
}

Response samples

Content type
application/json
{
  • "id": 123,
  • "name": "Entry",
  • "description": "Beginner or junior level job."
}

/api/v1/admin/job_level/

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
id
required
integer
name
required
string
description
string

Responses

Request samples

Content type
application/json
{
  • "id": 123,
  • "name": "Mid",
  • "description": "Intermediate level job."
}

Response samples

Content type
application/json
{
  • "id": 123,
  • "name": "Mid",
  • "description": "Intermediate level job."
}

/api/v1/admin/job_level/

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
id
required
integer

Responses

Request samples

Content type
application/json
{
  • "id": 123
}

Response samples

Content type
application/json
{
  • "message": "Job level with id 123 was deleted successfully"
}

/api/v1/admin/job_level/{id}

Authorizations:
bearerAuth
path Parameters
id
required
any
v1
required
string
Default: "v1"

Responses

/api/v1/admin/auth/logout

path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
refresh_token
required
string

Responses

Request samples

Content type
application/json
{
  • "refresh_token": "string"
}

Response samples

Content type
application/json
{
  • "message": "Logged out successfully"
}

/api/v1/admin/auth/refresh

path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
refresh_token
required
string

Responses

Request samples

Content type
application/json
{
  • "refresh_token": "string"
}

/api/v1/admin/auth/login

path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
email
required
string
password
required
string

Responses

Request samples

Content type
application/json
{
  • "email": "admin@example.com",
  • "password": "password123"
}

Response samples

Content type
application/json
{
  • "accessToken": "string",
  • "refreshToken": "string"
}

Auth

Authentication related end-points

/api/v1/jobportal/auth/register

path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
email
required
string
password
required
string
first_name
string
last_name
string
phone_number
string

Responses

Request samples

Content type
application/json
{
  • "email": "john@email.com",
  • "password": "password123",
  • "first_name": "John",
  • "last_name": "Doe",
  • "phone_number": "1234567890"
}

Response samples

Content type
application/json
{
  • "message": "Registration successful"
}

/api/v1/jobportal/auth/login

path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
email
required
string
password
required
string

Responses

Request samples

Content type
application/json
{
  • "email": "john@email.com",
  • "password": "password123"
}

Response samples

Content type
application/json
{
  • "accessToken": "string",
  • "refreshToken": "string"
}

/api/v1/jobportal/auth/refresh

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
refresh_token
required
string

Responses

Request samples

Content type
application/json
{
  • "refresh_token": "string"
}

Response samples

Content type
application/json
{
  • "access_token": "string",
  • "refresh_token": "string"
}

/api/v1/jobportal/auth/logout

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
refresh_token
required
string

Responses

Request samples

Content type
application/json
{
  • "refresh_token": "string"
}

/api/v1/admin/auth/logout

path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
refresh_token
required
string

Responses

Request samples

Content type
application/json
{
  • "refresh_token": "string"
}

Response samples

Content type
application/json
{
  • "message": "Logged out successfully"
}

/api/v1/admin/auth/refresh

path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
refresh_token
required
string

Responses

Request samples

Content type
application/json
{
  • "refresh_token": "string"
}

/api/v1/admin/auth/login

path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
email
required
string
password
required
string

Responses

Request samples

Content type
application/json
{
  • "email": "admin@example.com",
  • "password": "password123"
}

Response samples

Content type
application/json
{
  • "accessToken": "string",
  • "refreshToken": "string"
}

Seed

Seed related end-points

/api/v1/seed/admin

path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/seed/department

path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/seed/job_type

path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/seed/job_level

path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/seed/roles

path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/seed/organization_category

path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/seed/work_style

path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/seed/all

path Parameters
v1
required
string
Default: "v1"

Responses

Jobportal

Jobportal related end-points

/api/v1/jobportal/application/all_apliactions

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
start
required
number
end
required
number

Responses

Request samples

Content type
application/json
{
  • "start": 0,
  • "end": 10
}

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

/api/v1/jobportal/application/

path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
fullName
required
string
email
required
string
phone
required
string
linkedIn_url
required
string
resume_file
required
string
candidate_id
string

Responses

Request samples

Content type
application/json
{
  • "fullName": "John Doe",
  • "email": "john@email.com",
  • "phone": "1234567890",
  • "linkedIn_url": "linkedin.com/john",
  • "resume_file": "resume.pdf",
  • "candidate_id": "abc123"
}

Response samples

Content type
application/json
{
  • "message": "Application submitted successfully"
}

/api/v1/jobportal/auth/register

path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
email
required
string
password
required
string
first_name
string
last_name
string
phone_number
string

Responses

Request samples

Content type
application/json
{
  • "email": "john@email.com",
  • "password": "password123",
  • "first_name": "John",
  • "last_name": "Doe",
  • "phone_number": "1234567890"
}

Response samples

Content type
application/json
{
  • "message": "Registration successful"
}

/api/v1/jobportal/auth/login

path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
email
required
string
password
required
string

Responses

Request samples

Content type
application/json
{
  • "email": "john@email.com",
  • "password": "password123"
}

Response samples

Content type
application/json
{
  • "accessToken": "string",
  • "refreshToken": "string"
}

/api/v1/jobportal/auth/refresh

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
refresh_token
required
string

Responses

Request samples

Content type
application/json
{
  • "refresh_token": "string"
}

Response samples

Content type
application/json
{
  • "access_token": "string",
  • "refresh_token": "string"
}

/api/v1/jobportal/auth/logout

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
refresh_token
required
string

Responses

Request samples

Content type
application/json
{
  • "refresh_token": "string"
}

/api/v1/jobportal/job/all_jobs

path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
start
required
number
end
required
number

Responses

Request samples

Content type
application/json
{
  • "start": 0,
  • "end": 10
}

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

/api/v1/jobportal/job/id

path Parameters
id
required
any
v1
required
string
Default: "v1"

Responses

/api/v1/jobportal/organizations

query Parameters
page
any
limit
any
search
any

Responses

Response samples

Content type
application/json
{
  • "page": 1,
  • "limit": 10,
  • "totalPages": 1,
  • "totalCount": 10,
  • "data": [
    ]
}

/api/v1/jobportal/organization/{id}

path Parameters
id
required
any
v1
required
string
Default: "v1"

Responses

/api/v1/jobportal/main/popular-category

path Parameters
v1
required
string
Default: "v1"

Responses

Response samples

Content type
application/json
{
  • "departments": {
    },
  • "_count": {
    }
}

/api/v1/jobportal/main/featured-jobs

path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/jobportal/main/top-recruiters

path Parameters
v1
required
string
Default: "v1"

Responses

Response samples

Content type
application/json
{
  • "name": "Miththiran Inc",
  • "logo_url": null,
  • "address": null,
  • "organization_categories": {
    },
  • "_count": {
    }
}

/api/v1/jobportal/main/counts

path Parameters
v1
required
string
Default: "v1"

Responses

Dashboard

Dashboard related end-points

/api/v1/dashboard/auth/register

path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
organization_name
required
string
organization_email
required
string
organization_category_id
required
integer
first_name
required
string
last_name
required
string
email
required
string
password
required
string
phone_number
required
string

Responses

Request samples

Content type
application/json
{
  • "organization_name": "Acme Inc",
  • "organization_email": "contact@acme.com",
  • "organization_category_id": 123,
  • "first_name": "John",
  • "last_name": "Doe",
  • "email": "john@acme.com",
  • "password": "password123",
  • "phone_number": "1234567890"
}

Response samples

Content type
application/json
{
  • "message": "Registered successfully"
}

/api/v1/dashboard/auth/login

path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
email
required
string
password
required
string

Responses

Request samples

Content type
application/json
{
  • "email": "john@acme.com",
  • "password": "password123"
}

Response samples

Content type
application/json
{
  • "accessToken": "string",
  • "refreshToken": "string"
}

/api/v1/dashboard/auth/refresh

path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
refresh_token
required
string

Responses

Request samples

Content type
application/json
{
  • "refreshToken": "string"
}

/api/v1/dashboard/auth/logout

path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
refresh_token
required
string

Responses

Request samples

Content type
application/json
{
  • "refreshToken": "string"
}

/api/v1/dashboard/job

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/dashboard/job/add

path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
department_id
required
integer
title
required
string

Responses

Request samples

Content type
application/json
{
  • "department_id": 123,
  • "title": "Software Engineer"
}

Response samples

Content type
application/json
{
  • "message": "Job added successfully"
}

/api/v1/dashboard/job/edit

path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
id
integer
title
required
string
department_id
required
integer

Responses

Request samples

Content type
application/json
{
  • "department_id": 123,
  • "title": "Software Engineer"
}

Response samples

Content type
application/json
{
  • "message": "Job added successfully"
}

/api/v1/dashboard/job/delete

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
id
required
integer

Responses

Request samples

Content type
application/json
{
  • "id": 123
}

/api/v1/dashboard/job/{id}

Authorizations:
bearerAuth
path Parameters
id
required
any
v1
required
string
Default: "v1"

Responses

/api/v1/dashboard/data/department

path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/dashboard/data/job_type

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/dashboard/data/job_level

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/dashboard/data/organization_category

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/dashboard/data/work_style

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/dashboard/organization/department

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/dashboard/organization/job_level

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/dashboard/organization/job

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"

Responses

/api/v1/dashboard/organization/work_style

Authorizations:
bearerAuth
path Parameters
v1
required
string
Default: "v1"

Responses

Test

/api/v1/cv/upload

path Parameters
v1
required
string
Default: "v1"
Request Body schema: application/json
cv
required
string <binary>

Responses

Request samples

Content type
application/json
{
  • "cv": "file_contents_here"
}

Response samples

Content type
application/json
{
  • "message": "CV uploaded successfully"
}