Skip to content
Recruso API

Get site activity details

GET
/v1/clients/{clientId}/sites/{siteId}/contact-persons/{contactPersonId}/activities/{id}
curl --request GET \
  --url https://api2.recruso.co.uk/v1/clients/1/sites/1/contact-persons/1/activities/1 \
  --header 'Authorization: <Authorization>'

Returns one activity logged against a contact at one of your own agency’s sites, including its follow-up dates and audit fields.

The client, site and contact in the route must line up — the site must belong to the client and the contact to the site — and any mismatch returns 404 rather than 403.

The activity must also belong to the contact in the route.

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”
clientId
required
integer format: int32

The clientId path parameter

siteId
required
integer format: int32

The siteId path parameter

contactPersonId
required
integer format: int32

The contactPersonId path parameter

id
required
integer format: int32

The id path parameter

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media typeapplication/json

The full record for one site activity.

object
siteActivityId

The activity’s unique identifier, assigned by Recruso.

integer format: int32
siteContactPersonId

The site contact this activity was logged against.

integer format: int32
userId

The Recruso user who logged the activity.

integer format: int16
nullable
activityDate

When the activity took place, in UK local time (GMT/BST). Required.

string format: date-time
description

What the activity was — the call, visit or email being recorded.

string
nullable
actionTaken

What was done or agreed as a result.

string
nullable
nextCallDate

When to follow up next, in UK local time (GMT/BST).

string format: date-time
nullable
lastVisited

When the site was last visited, in UK local time (GMT/BST).

string format: date-time
nullable
activityTypeId

The kind of activity, as an id from your agency’s Activity types lookup. An id that does not belong to your agency returns 400.

integer format: int16
nullable
eventId

Your own reference for the activity, such as a calendar event id. Set when the activity is created and cannot be changed afterwards.

string
nullable
createdBy

The Recruso user who created the activity.

integer format: int16
nullable
createdOn

When the activity record was created, in UK local time (GMT/BST) - not UTC.

string format: date-time
nullable
modifiedBy

The Recruso user who last updated the activity. Null until it is first updated.

integer format: int16
nullable
modifiedOn

When the activity was last updated, in UK local time (GMT/BST) - not UTC. Null until it is first updated.

string format: date-time
nullable
Example
{
  "siteActivityId": 7420,
  "siteContactPersonId": 88,
  "userId": 12,
  "activityDate": "2026-05-14T10:30:00",
  "description": "Called to confirm cover for the bank holiday weekend.",
  "actionTaken": "Agreed 6 pickers for Saturday, confirmed by email.",
  "nextCallDate": "2026-05-21T09:00:00",
  "lastVisited": "2026-05-02T13:15:00",
  "activityTypeId": 4,
  "eventId": "cal-2026-05-14-0930",
  "createdBy": 12,
  "createdOn": "2026-05-14T10:41:52",
  "modifiedBy": 12,
  "modifiedOn": "2026-05-15T08:12:03"
}

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"
}