View Source

The Courses and Delegates API feeds allow you to integrate course and Delegate information with other software that you have in use across your business such as a LMS, VLE, or CRM.

The feed is available if you have the API Feeds module. Please speak to your CSM to find out more about this module.

Purpose of the API Feed

This Course and Delegates API Feeds can be used to connect your accessplanit platform to other learning/training or employee-based software, such as your VLE system to sync your employee's learning records, or your intranet to display your upcoming courses.

Connecting your software and syncing the data between them removes the need for double data entry, reduces the risk of human error and eases the headache of managing multiple platforms!

Fields Available in the API Feeds

There are five feeds included for Course and Delegate data.

Each of these five feeds have varying levels of read, write, and create access.

Course Templates

This feed is used for accessing the details of Course Templates within the database.

It is not possible to update Course Templates or create new Course Templates via the feed. These actions should always be managed by an Administrator within the accessplanit platform.

Field	GET (Read)	PUT (Update)	POST (Create new)	Validation
Course Template ID				n/a
Name				n/a
Type				n/a
Category (As an array)				n/a

Courses (Dates)

This feed is used for accessing the details of Courses (dates) within the database. Please note, it is not possible to create Courses via this feed but it is possible to update them.

Field	GET (Filter)	Validation
CourseDateID		n/a
External ID
Name
Start Date
End Date
Minimum Sessions
Maximum Sessions
Company ID (training provider)
Net Cost
Tax
Charge per delegate
Status
Places Remaining		n/a
Waiting List Type
Sessional
Sessional Cost Type
Duration
Duration Type
Image URL
Aims Text	Please note that any double spaces ' ' in Aims text are not recognised when filtering API Feeds
Links Rel: SELF, Action: GET, url: api/v1/coursedates/{id} Rel: Trainers, Action: GET, url: api/v1/coursedates/{id}/trainers Rel: Venues, Action: GET, url: api/v1/coursedates/{id}/venues Rel: CourseTemplate, Action: GET, url: api/v1/coursetemplates/{courseid}~{companyid}		n/a
Course is advertised
Advertised start date		Must be before advertised end date
Advertised end date		Must be after advertised start date
Max places		Must be positive and must be higher than minimum places
Min places		Must be positive and must be lower than maximum places
Course is exclusive
Sessions Contains the information of the sessional courses

Here are some example filters that you will be able to use with your Course API Feed:

Only include advertised courses:

{{apiroot}}/coursedates?CourseIsAdvertised=true

Only include courses that are not advertised:

{{apiroot}}/coursedates?CourseIsAdvertised=false

Only include a specific course

{{apiroot}}/coursedates?CourseDateID=12066

Only include courses with more than 3 places remaining (gt = greater than)

{{apiroot}}/coursedates?PlacesRemaining=gt:3

Only include courses with less than 2 places remaining (let = less than)

{{apiroot}}/coursedates?PlacesRemaining=lt:2

Only include courses starting at 5th Oct 2021 at 9am

{{apiroot}}/coursedates?StartDate=2021-10-05T09:00:00

Only include courses starting w/c 28th June

{{apiroot}}/coursedates?StartDate=gt:2021-06-28T07:59:59&lt:2021-07-02T18:00:00

Only include courses that contain the words "First Aid" in the name

{{apiroot}}/coursedates?Name=“First Aid”

Only include available courses

{{apiroot}}/coursedates?Status=Available

Exclude courses that are cancelled or completed

{{apiroot}}/coursedates?Status=not:Completed&Status=not:Cancelled

Only include courses that do not have a start date (such as eLearning courses)

{{apiroot}}/coursedates?StartDate=NULL

Only include courses that do have a start date

{{apiroot}}/coursedates?StartDate=not:NULL

Delegates

This feed is used for accessing the details of Delegates. Delegates are Users assigned to Courses. It is possible to read, update, and create Delegate records via the feed.

Field	POST (Create new)	Validation
User ID	Mandatory	Must validate against an existing user
Course Date Link	Mandatory	Must validate against an existing course date
Delegate Status		Must validate against statuses
Date Booked		n/a
Score		Numeric (0 - 100)

Trainers

This feed is used for accessing the details of Trainers.

It is not possible to update or create new Trainers - this task must be completed in the accessplanit platform.

Field	GET (Read)	PUT (Update)	POST (Create new)	Validation
Trainer Label				n/a
Trainer Description				n/a

Venues

This feed is used for accessing the details of Venues.

It is not possible to update or create new Venues - this task must be completed in the accessplanit platform.

Field	GET (Read)	PUT (Update)	POST (Create new)	Validation
Venue Label				n/a
Venue Address				n/a
Venue Town				n/a
Venue County				n/a
Venue Country				n/a
Venue Postcode				n/a
Venue Phone				n/a
Venue Email				n/a
Venue Website				n/a
Venue description				n/a

Connecting to the API

DISCLAIMER: By using accessplanit APIs, you agree to our terms of use.

To gain access to your accessplanit platform's API Feeds or to ask any questions about them, please speak to the CSM team at accessplanit on csm@accessplanit.com

On this page: