API Documentation.
Need to access Vale Learning training records externally? Using the ValeLearning API Platform, you can access and integrate records into your software.
Request API AccessTo get started using the ValeLearning API, please review the following sections:
Before you start Register with L&D Verifying your accountYou will need:
Before your Client ID and Access Tokens are issued, we need to verify the legitimacy of your application. Please fill out the following form to request a developer account. Developer accounts contain your unique Client ID and Access Tokens.
Before you can query the API, you need to verify your account. Start by constructing an authorization window URL below, replacing {CLIENT_ID} with your Client ID and {ACCESS_TOKEN} with your Client Access Token.
https://api.valelearning.ca/auth?
client_id={CLIENT_ID}
&client_secret={ACCESS_TOKEN}
&scope=validate_token
&response_type=json
If the credentials inputted above are valid, you will recieve the following JSONP response. Once recieved, you can start to perform basic queries with the API.
{"Success":"Account Validated. Your CLIENT_ID and ACCESS_TOKEN are valid."}
To begin requesting contractor training data, please review the following sections:
All Contractor Information Single Contractor Profile Module Completions Data Request Types Data Request Limits Module Reference ListYou can query the API to recieve a full or ranged export of all contractor information. This is the only query that supports {START} and {END} parameters that target when the profile was last updated or created. Start by constructing an authorization window URL below. In addition to your account credentials, you will need to replace {START} and {END} with a date string (YYYY-MM-DD). If you wish to export all contractors, then you will set both {START} and {END} parameters to "all".
Since responses are formatted in JSONP, all queries require a unique callback. Replace {CALL} with your unique numerical callback.
https://api.valelearning.ca/auth?
client_id={CLIENT_ID}
&client_secret={ACCESS_TOKEN}
&scope=get_profiles
&value=all
&start={START}
&end={END}
&response_type=json
&callback={CALL}
If contractor accounts where updated or created within your parameters, the profiles will be exported in a JSONP response with your unique callback superseding the object. Please review the example response below:
123 ([{
"id": 1,
"FirstName": "Brad",
"LastName": "Dankerson",
"ValeID": "C654321",
"DateOfBirth": "1990-06-01",
"ContractorPhone": "7051234567",
"ContractorEmail": "brad.dankerson@vale.com",
"ContractorOccupation": "Project Management",
"ContractorLocation": "Sudbury, ON",
"CompanyName": "Vale Canada",
"CompanyPhone": "7051234567",
"EmergencyName": "Kathy Dankerson",
"EmergencyPhone": "7051234567",
"Type": "N",
"RecordUpdated": "2022-01-25",
}, {
"id": 2,
"FirstName": "Steven",
"LastName": "Branks",
"ValeID": "C123456",
"DateOfBirth": "1989-06-12",
"ContractorPhone": "7051234567",
"ContractorEmail": "steven.branks@vale.com",
"ContractorOccupation": "Technical Support",
"ContractorLocation": "Sudbury, ON",
"CompanyName": "Vale Canada",
"CompanyPhone": "7051234567",
"EmergencyName": "Brittney Branks",
"EmergencyPhone": "7051234567",
"Type": "N",
"RecordUpdated": "2022-01-25",
},
...
])
You can query the API to recieve a contractors full profile in a JSONP response. Start by constructing an authorization window URL below. In addition to your account credentials, you will need to replace {ID} with the contractors Vale Identification. Vale ID's come in many shapes and sizes such as:
Since responses are formatted in JSONP, all queries require a unique callback. Replace {CALL} with your unique numerical callback.
https://api.valelearning.ca/auth?
client_id={CLIENT_ID}
&client_secret={ACCESS_TOKEN}
&scope=user_profile
&value={ID}
&response_type=json
&callback={CALL}
If the contractor exists, the profile will be exported in a JSONP response with your unique callback superseding the object. Please review the example response below:
123 ({
"id": 1,
"FirstName": "Brad",
"LastName": "Dankerson",
"ValeID": "C654321",
"DateOfBirth": "1990-06-01",
"ContractorPhone": "7051234567",
"ContractorEmail": "brad.dankerson@vale.com",
"ContractorOccupation": "Project Management",
"ContractorLocation": "Sudbury, ON",
"CompanyName": "Vale Canada",
"CompanyPhone": "7051234567",
"EmergencyName": "Kathy Dankerson",
"EmergencyPhone": "7051234567",
"Type": "N",
"RecordUpdated": "2022-01-25",
...
})
In addition to the contractor information above, each contractor profile includes a full list of training records. Each training module has a unique ID and has five (5) data points. In the example below, the data pertains to Module ID 32 - Tier 1: General Orientation. For a full list of Module ID's, please view the Module ID Reference List.
123 ({
...
"RecordUpdated": "2022-01-25",
"ID32": "PASS",
"ID32-CompletedDate": "2020-01-02",
"ID32-ExpiryDate": "2022-01-01",
"ID32-Attempts": "0",
"ID32-Progression": null,
...
})
The list below highlights the values of the JSON response above.
You can query the API to recieve module completions in a JSONP response. Start by constructing an authorization window URL below. In addition to your account credentials, you will need to replace {ID} with your desired course ID. You can find the full Module ID Reference List below in this tutorial.
Since responses are formatted in JSONP, all queries require a unique callback. Replace {CALL} with your unique numerical callback.
https://api.valelearning.ca/auth?
client_id={CLIENT_ID}
&client_secret={ACCESS_TOKEN}
&scope=course_export
&value={ID}
&response_type=json
&callback={CALL}
If the Module ID is valid, contractor profiles will be exported in a JSONP response with your unique callback superseding the object. Please review the example response below:
123 ([{
"id": 1,
"RecordUpdated": "2022-01-25",
"FirstName": "Brad",
"LastName": "Dankerson",
"ValeID": "C654321",
"CourseID": "32",
"CourseStatus": "PASS",
"CourseCompleted": "2020-11-21",
"CourseExpiry": "2022-11-21"
}, {
"id": 2,
"RecordUpdated": "2022-01-25",
"FirstName": "Steven",
"LastName": "Branks",
"ValeID": "C123456",
"CourseID": "32",
"CourseStatus": "PASS",
"CourseCompleted": "2020-11-18",
"CourseExpiry": "2022-11-18"
},
...
])
The list below highlights the values of the JSON response above:
The ValeLearning API delivers data in two (2) formats. JSONP is the default data delivery type. If your application does not support JSONP, you can request the data in a downloadable CSV format for use in Microsoft Excel or simular applications. To request the CSV data type, simply change the {TYPE} object to equal "csv".
&response_type={TYPE}
Queries that support CSV format:
The ValeLearning API has the following query limits in place:
If you need these limits increased, please contact the system administrator.
Below is the full course offerings from ValeLearning.ca. If a new course is added, it will be recorded below.
Modules that have been replaced or removed are listed as depreciated. Contractor profiles may contain records associated with these modules but they are no longer supported or considered valid training.