Verso Sandbox API

Employees

Endpointhttps://api.versohq.dev

Create and manage employee records

List employees for your tenant

GET

https://api.versohq.dev

/employees

Retrieves all employees associated with your tenant, optionally filtered by division.

List employees for your tenant › query Parameters

divisionId

integer · int32

Filter by division identifier

filter

string

The OData filter expression (with support for attribute fields)

orderBy

string

The OData order-by expression (with support for attribute fields)

result

string · enum

The query result type: items, count or items with count (default: result items)

The query result type

Enum values:

Items

Count

ItemsWithCount

select

string

The OData field selection expression

skip

integer · int64

The number of items in the queried collection that are to be skipped

status

string · enum

The object status (default: all status)

The object status

Enum values:

Active

Inactive

top

integer · int64

The number of items in the queried collection

List employees for your tenant › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List employees for your tenant › Responses

object[]

id

integer · int32

Unique identifier

identifier

string

firstName

string

lastName

string

culture

string

divisions

string[]

status

string · enum

The object status

Enum values:

Active

Inactive

GET/employees

curl --request GET \
  --url https://api.versohq.dev/employees \
  --header 'Authorization: <string>'

shell

Example Responses

[
  {
    "id": 0,
    "identifier": "identifier",
    "firstName": "firstName",
    "lastName": "lastName",
    "culture": "culture",
    "divisions": [
      "string"
    ],
    "status": "Active"
  }
]

json

application/json

Create a new employee

POST

https://api.versohq.dev

/employees

Creates a new employee for your tenant. You can optionally assign the employee to divisions.

Create a new employee › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Create a new employee › Request Body

identifier

string · required

Unique identifier for the employee (typically email)

firstName

string

Employee's first name

lastName

string

Employee's last name

culture

string

Employee's culture/locale (e.g., fr-FR, en-US)

divisions

string[]

Division names to assign the employee to

Create a new employee › Responses

Created

id

integer · int32

Unique identifier

identifier

string

firstName

string

lastName

string

culture

string

divisions

string[]

status

string · enum

The object status

Enum values:

Active

Inactive

POST/employees

curl --request POST \
  --url https://api.versohq.dev/employees \
  --header 'Authorization: <string>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "identifier": "identifier",
  "firstName": "firstName",
  "lastName": "lastName",
  "culture": "culture",
  "divisions": [
    "string"
  ]
}
'

shell

Example Request Body

{
  "identifier": "identifier",
  "firstName": "firstName",
  "lastName": "lastName",
  "culture": "culture",
  "divisions": [
    "string"
  ]
}

json

Example Responses

{
  "id": 0,
  "identifier": "identifier",
  "firstName": "firstName",
  "lastName": "lastName",
  "culture": "culture",
  "divisions": [
    "string"
  ],
  "status": "Active"
}

json

application/json

Divisions Payrolls

List employees for your tenant

GET

https://api.versohq.dev

/employees

Retrieves all employees associated with your tenant, optionally filtered by division.

List employees for your tenant › query Parameters

divisionId

integer · int32

Filter by division identifier

filter

string

The OData filter expression (with support for attribute fields)

orderBy

string

The OData order-by expression (with support for attribute fields)

result

string · enum

The query result type: items, count or items with count (default: result items)

The query result type

Enum values:

Items

Count

ItemsWithCount

select

string

The OData field selection expression

skip

integer · int64

The number of items in the queried collection that are to be skipped

status

string · enum

The object status (default: all status)

The object status

Enum values:

Active

Inactive

top

integer · int64

The number of items in the queried collection

List employees for your tenant › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List employees for your tenant › Responses

object[]

id

integer · int32

Unique identifier

identifier

string

firstName

string

lastName

string

culture

string

divisions

string[]

status

string · enum

The object status

Enum values:

Active

Inactive

Create a new employee

POST

https://api.versohq.dev

/employees

Creates a new employee for your tenant. You can optionally assign the employee to divisions.

Create a new employee › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Create a new employee › Request Body

identifier

string · required

Unique identifier for the employee (typically email)

firstName

string

Employee's first name

lastName

string

Employee's last name

culture

string

Employee's culture/locale (e.g., fr-FR, en-US)

divisions

string[]

Division names to assign the employee to

Create a new employee › Responses

Created

id

integer · int32

Unique identifier

identifier

string

firstName

string

lastName

string

culture

string

divisions

string[]

status

string · enum

The object status

Enum values:

Active

Inactive