Talent

Get Talent Activities

Returns a page of talent activities, ordered from newest to oldest, filtered by talent, date range, and activity type.

get/v1/talent/activity

Request

  • Base URL
    https://api.avionte.com/front-office
  • URL
    https://api.avionte.com/front-office/v1/talent/activity
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

Query parameters

talentIdinteger

The unique identifier for the talent whose activities to return. Required when startDate is omitted. Without talentId, the date range may span at most 31 days.

startDatestring date

The start date for the activity search, in UTC and formatted as yyyy-MM-dd. Required when talentId is omitted or when endDate is provided.

endDatestring date

The end date for the activity search, in UTC and formatted as yyyy-MM-dd. Defaults to startDate. Requires startDate and must not be earlier than it.

typeIdinteger

The activity type identifier used to filter the results. An unknown type returns an empty page.

pageinteger

The page number to return, starting at 1. Defaults to 1. Values below 1 are rejected.

pageSizeinteger

The number of activities per page. Must be between 1 and 100. Defaults to 25. A value outside this range is rejected.

Headers

RequestIdstring uuid

Unique request identifier in UUID format used to correlate request data to log entries and events.

Example:63680b86-c7e0-4a36-ae4a-d0d481089aff

Unique request identifier (UUID) used to correlate request data with log entries and events.

FrontOfficeTenantIdinteger

An integer identifier for the tenant that the request is being made for. Required when Tenant header is not provided.

Tenantstring

Tenant company code that determines data access scope during the request. Required when FrontOfficeTenantId header is not provided.

Response

A page of talent activities. The page is empty when nothing matches.

pageinteger

The page number, starting at 1.

pageSizeinteger

The maximum number of activities per page.

totalCountinteger

The number of activities matching the filters across all pages.

Example response

{
  "page": 1,
  "pageSize": 25,
  "totalCount": 143,
  "items": [
    {
      "id": 53892,
      "talentId": 283287,
      "typeId": 284,
      "typeName": "Interview completed",
      "activityDate": "2024-12-01T14:30:00Z",
      "enteredDate": "2024-12-01T14:35:12Z",
      "notes": "Need to call.",
      "userId": 42948,
      "show_in": 1
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.