Operations

Analyze Employee performance evidence

Return a pageable factual ranking and review signals from Team Pulse and Glow Moments for only the Employees visible to the member. It never recommends an employment decision.

Use when: Use first for best-performer, needs-attention, strengths, weaknesses, or workforce-comparison requests; follow nextOffset until null for the complete filtered cohort. Returns: factual visible-cohort ranks, performance scores, measured evidence, attention signals, counts, pagination, and guidance for human review.

POST

https://api.join.tl

api

operations

employees.analytics

Analyze Employee performance evidence

curl --request POST \
  --url https://api.join.tl/api/v1/operations/employees.analytics \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://api.join.tl/api/v1/operations/employees.analytics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.join.tl/api/v1/operations/employees.analytics"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "evaluatedEmployeeCount": 1,
    "evidenceWindow": {
      "endDate": "2026-01-15T00:00:00.000Z",
      "inclusive": true,
      "startDate": "2026-01-15T00:00:00.000Z",
      "timeZone": "UTC"
    },
    "exactCohort": false,
    "hasMore": false,
    "items": [
      {}
    ],
    "nextOffset": 1,
    "offset": 1,
    "returnedEmployeeCount": 1,
    "safety": {},
    "scoredEmployeeCount": 75
  },
  "requestId": "request_example_01"
}

{
  "error": {
    "code": "invalid-external-operation-input",
    "message": "The operation input is invalid."
  },
  "requestId": "request_example_400"
}

{
  "error": {
    "code": "not-authenticated",
    "message": "Authentication is required."
  },
  "requestId": "request_example_401"
}

{
  "error": {
    "code": "not-authorized",
    "message": "You are not allowed to perform this action."
  },
  "requestId": "request_example_403"
}

{
  "error": {
    "code": "not-found",
    "message": "The requested record was not found."
  },
  "requestId": "request_example_404"
}

{
  "error": {
    "code": "external-action-conflict",
    "message": "The action conflicts with current state."
  },
  "requestId": "request_example_409"
}

{
  "error": {
    "code": "request-too-large",
    "message": "The request body is too large."
  },
  "requestId": "request_example_413"
}

{
  "error": {
    "code": "too-many-requests",
    "message": "Too many requests."
  },
  "requestId": "request_example_429"
}

{
  "error": {
    "code": "internal-error",
    "message": "The request could not be completed."
  },
  "requestId": "request_example_500"
}

{
  "error": {
    "code": "temporarily-unavailable",
    "message": "The service is temporarily unavailable."
  },
  "requestId": "request_example_503"
}

Authorizations

Authorization

string

header

required

OAuth access token issued for the REST resource.

Body

application/json

endDate

string

Inclusive UTC evidence end date in YYYY-MM-DD. Omit both dates for the trailing six-month default.

Pattern: ^\d{4}-\d{2}-\d{2}$

limit

integer

default:25

Required range: 1 <= x <= 100

offset

integer

default:0

Required range: 0 <= x <= 499

selectedCompanies

string[]

Exact Jointl company IDs; empty means every authorized company, subject to the cohort bound.

Maximum array length: 100

Required string length: 1 - 128

Pattern: ^[A-Za-z0-9_-]+$

selectedEmployeeStatus

enum<string>[]

Defaults to active Employees. Pass an empty array to include every authorized Employee status.

Maximum array length: 100

Available options:

active,

left

selectedTags

string[]

Exact Jointl tag IDs; empty means every tag.

Maximum array length: 100

Required string length: 1 - 128

Pattern: ^[A-Za-z0-9_-]+$

startDate

string

Inclusive UTC evidence start date in YYYY-MM-DD. Omit both dates for the trailing six-month default.

Pattern: ^\d{4}-\d{2}-\d{2}$

Response

Operation completed.

data

object

required

Show child attributes

requestId

string

required

Request correlation identifier.

⌘I

Analyze Employee performance evidence

curl --request POST \
  --url https://api.join.tl/api/v1/operations/employees.analytics \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://api.join.tl/api/v1/operations/employees.analytics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.join.tl/api/v1/operations/employees.analytics"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "evaluatedEmployeeCount": 1,
    "evidenceWindow": {
      "endDate": "2026-01-15T00:00:00.000Z",
      "inclusive": true,
      "startDate": "2026-01-15T00:00:00.000Z",
      "timeZone": "UTC"
    },
    "exactCohort": false,
    "hasMore": false,
    "items": [
      {}
    ],
    "nextOffset": 1,
    "offset": 1,
    "returnedEmployeeCount": 1,
    "safety": {},
    "scoredEmployeeCount": 75
  },
  "requestId": "request_example_01"
}

{
  "error": {
    "code": "invalid-external-operation-input",
    "message": "The operation input is invalid."
  },
  "requestId": "request_example_400"
}

{
  "error": {
    "code": "not-authenticated",
    "message": "Authentication is required."
  },
  "requestId": "request_example_401"
}

{
  "error": {
    "code": "not-authorized",
    "message": "You are not allowed to perform this action."
  },
  "requestId": "request_example_403"
}

{
  "error": {
    "code": "not-found",
    "message": "The requested record was not found."
  },
  "requestId": "request_example_404"
}

{
  "error": {
    "code": "external-action-conflict",
    "message": "The action conflicts with current state."
  },
  "requestId": "request_example_409"
}

{
  "error": {
    "code": "request-too-large",
    "message": "The request body is too large."
  },
  "requestId": "request_example_413"
}

{
  "error": {
    "code": "too-many-requests",
    "message": "Too many requests."
  },
  "requestId": "request_example_429"
}

{
  "error": {
    "code": "internal-error",
    "message": "The request could not be completed."
  },
  "requestId": "request_example_500"
}

{
  "error": {
    "code": "temporarily-unavailable",
    "message": "The service is temporarily unavailable."
  },
  "requestId": "request_example_503"
}

Jointl REST API and OAuth

Greenhouse integration

Zapier event delivery

Analyze Employee performance evidence

Authorizations

Body

Response