Returning Total Activities per PCR User within Date Range

Tagged:

Currently contains 5 posts

Avatar

September 29, 2021 21:22

sbradford

Is it possible to search for name record activities, filtering based on activity type and PCR user, and return the total number of activities within a given date range via the API? Similar to the numbers shown in a Metrics Report via Reports > Auditing Reports > Metrics Report.

Example: I want to find the number of INTERVIEW/Screen activities in the ETS Dental database generated by user MPACE with an activity date of 9/29/2021.

1) Is the above example achievable through the /candidates/activities endpoint? Or would another endpoint be more efficient for simply getting the total # of INTERVIEW/Screen activities that user MPACE generated?

2) How do I filter/query based on activity type, activity date range, and PCR username?

Apologies if this is answered somewhere in the documentation or another forum post – am new to the API and just want to get started in the right direction. Thanks! -Scott

Avatar

September 29, 2021 23:02

Jarrid-PCRecruiter

Hi Scott,

This should be possible using the candidate activities end-point documented here: https://www.pcrecruiter.net/apidocs_v2/

Candidate Activities
The candidate activities endpoint can be used to retrieve, create, update or delete activities for a specific candidate record. The endpoint format for this would be /candidates/{CandidateId}/activities. Activities in PCRecruiter are actions and the details of those actions record to the activities screen for a record.

Data parameters
ActivityId – Unique id for the activity record
CandidateId – Unique id for the candidate this activity record is for
UserName – Username that created the activity
ActivityDate – Date and time the activity was created or set to take place
ActivityText – The text/body of the activity
ActivityType – The type of activity for the activity record
ActivityResult – Result is a sub-type of activity type. This is not always used
InterviewId – InterviewId is the unique id for the interview if this activity originated from an interview record

Avatar

October 01, 2021 15:45

sbradford

Hey Jarrid,

Thanks very much for the quick response! Tried this out, but I see I have to enter a CandidateId. Since I am searching for candidates by activity type/date/PCR user (rather than ID), is there a way to utilize the candidate activities endpoint without knowing the CandidateId(s)?

Thanks,
Scott

Avatar

October 01, 2021 15:56

sbradford

Hey Jarrid,

I just ended up utilizing the /candidates/activities endpoint instead, as this appears to be exactly what I was looking for!

Thanks again,
Scott

Avatar

October 01, 2021 15:59

Jarrid-PCRecruiter

No worries and sorry about that — glad you found the correct end-point, let me know if you have any additional questions.

Reply to thread