Getting Started.

To get started using the ValeLearning API, please review the following sections:

Before you start Register with L&D Verifying your account

Before you start

You will need:

Register with L&D

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.

Verifying your account credentials

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

Supported API Queries.

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 List

Requesting All Contractor Information

You 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",
},
... ])

Requesting a Single Contractor Profile

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.

Requesting Module Completions

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:

Data Request Types

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:

Data Request Limits

The ValeLearning API has the following query limits in place:

If you need these limits increased, please contact the system administrator.

Training Index ( items).

Module ID Reference List

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.

Sudbury Operations

Port Colborne Operations

Long Harbour Operations

Voisey's Bay Operations

Thompson Operations

Critical Activity Requirements (CAR)

Zero Energy State (ZES)

Supplement Training

Administrator Login Designed by ota.studio
By using our site, you acknowledge that you have read and understand our Terms of Use and User Policy statements.