Skip to content
Recruso API

Get one of a worker's activities

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

Returns a single entry from a worker’s activity feed in your own agency.

An entry that belongs to a different worker, or to another agency, returns 404 rather than 403, so its 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

id
required
integer format: int32

The id path parameter

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media typeapplication/json
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
{
  "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"
}