Skip to content
Recruso API

List a worker's activities

GET
/v1/workers/{workerId}/activities
curl --request GET \
  --url https://api2.recruso.co.uk/v1/workers/1/activities \
  --header 'Authorization: <Authorization>'

Returns a worker’s activity feed in your own agency, newest activity first.

Each entry says when the activity happened, what was said, what was done and when to call back, together with the Recruso user who logged it. The list is not paged, so a worker contacted often returns a long one.

A worker id belonging to another agency returns 404 rather than 403, so their existence is never disclosed.

Access. Requires a client-credentials access token. Tokens issued through the interactive user login are rejected.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
workerId
required
integer format: int32

The workerId path parameter

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media typeapplication/json

A worker’s activity feed.

object
workerId

The worker the feed belongs to.

integer format: int32
activities

The entries, newest activity first.

Array<object>

One entry in a worker’s activity feed.

object
workerActivityId

The entry’s identifier.

integer format: int32
activityDate

When the activity happened, in UK local time.

string format: date-time
activityTypeId

The kind of activity, as an id from your agency’s Activity types lookup.

integer format: int16
nullable
description

What was said or done.

string
nullable
actionTaken

What was done about it.

string
nullable
nextCallDate

When to call the worker back, in UK local time.

string format: date-time
nullable
userId

The Recruso user id (tblUsers.UserID) of the consultant the activity involved, not the ASP.NET Identity id. Set when the activity is logged and not changed afterwards.

integer format: int16
nullable
eventId

The Outlook calendar event id, when the activity was raised as a calendar entry.

string
nullable
createdBy

The Recruso user id (tblUsers.UserID) that logged the entry, not the ASP.NET Identity id. The generic audit column; userId above is the consultant involved, and in most cases the two are the same person.

integer format: int16
nullable
createdOn

When the entry was logged, in UK local time.

string format: date-time
nullable
Example
{
  "workerId": 4821,
  "activities": [
    {
      "workerActivityId": 9930,
      "activityDate": "2026-09-04T14:32:00",
      "activityTypeId": 4,
      "description": "Called about Thursday nights at Trafford Park; worker is interested.",
      "actionTaken": "Pencilled in for the Thursday shift; to confirm Monday.",
      "nextCallDate": "2026-09-08T09:00:00",
      "userId": 100,
      "eventId": "AAMkAGI2TG93AAA=",
      "createdBy": 100,
      "createdOn": "2026-09-04T14:35:11"
    }
  ]
}

401

Section titled “401”

Unauthorized

Media typeapplication/problem+json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

403

Section titled “403”

Forbidden

Media typeapplication/problem+json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

404

Section titled “404”

Not Found

Media typeapplication/problem+json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}