# Integration Results Webhook #### Process It is worth noting that an exam undergoes a number of state changes during its life: 1. 1. 1. 1. Ready 2. Incomplete 3. Finished 4. Review 5. Problem 6. Invalidated 7. Complete 8. Disabled Currently webhook calls are executed at the following processing points: - - - - When The status of the exam changes to Finished (Optional) - When the status of the exam changes to Completed - If any type of reset is executed for the exam - If the exam is invalidated - If the exam encountered a technical issue When any of the above described events occur, a check is made the determines if the test has a tracking code assigned to it. Tracking codes are created and maintained by iTEP staff. These codes are used to identify the endpoint, authorization methods and parameters, and if a call is to be executed when the test is finished. The call is a post call. The data in the all is a single form-encoded field named data, and the data is a JSON string that contains the results. See [Webhook Output Sample ](https://documentation.iteponline.com/books/integration/page/webhook-output-sample "Webhook Output Sample")for an example. ##### Headers sent: [](https://documentation.iteponline.com/uploads/images/gallery/2024-08/KBEdxAzcpCWN5Qhl-image.png) ##### Data sent: [](https://documentation.iteponline.com/uploads/images/gallery/2024-08/7Zpnd7bjOUnZayn3-image.png)
### [IMPORTANT!](https://documentation.iteponline.com/books/integration/page/webhook-output-sample "Webhook Output Sample") |
Note that there is **ONE** form encoded field named **data.** The field **data** contains a JSON encoded string that, in turn, contains all of the fields sent by the result webhook. |
**OID** | the remote system unique ID for this test |
**TestID** | the iTEP Test ID |
**Duration** | Number of minutes candidate spent taking the exam |
**TestDate** | M/D/YYYY the date the test was finished M will be a number between 1 and 12 D will be a number between 1 and 31 YYYY will be a number greater than 1900 |
**TestMonth** | the month the test was finished **Valid values:** a number between 1 and 12 |
**TestDay** | the day of the month the test was finished **Valid values:** a number between 1 and 31 |
**TestYear** | the year the test was finished **Valid values:** a number greater than 1900 |
**score\_report\_url** | URL that will generate a formatted score report with skill breakdowns and explanations |
**Overall\_Level** | the iTEP level assigned to the test as a whole **Valid values:** 0.0 - 6.0 |
**Overall\_cefr** | Overall CEFR level See [CEFR Levels](https://documentation.iteponline.com/books/definitions/page/cefr-level "CEFR Levels") for definition |
**Status** | Exam status, as described in the previous section |
**Grammar\_Level** | the iTEP level assigned to the grammar section **Valid values:** 0.0 - 6.0 |
**Grammar\_Score** | the iTEP Test ID |
**Grammar\_Percent** | the percent of correct answers for the grammar section **Valid values:** 0 - 100 |
**Grammar\_cefr** | Grammar CEFR level See [CEFR Levels](https://documentation.iteponline.com/books/definitions/page/cefr-level "CEFR Levels") for definition |
**Listening\_Level** | the iTEP level assigned to the Listening section **Valid values:** 0.0 - 6.0 |
**Listening\_Score** | the iTEP Test ID |
**Listening\_Percent** | the percent of correct answers for the Listening section **Valid values:** 0 - 100 |
**Listening\_cefr** | Listening CEFR level See [CEFR Levels](https://documentation.iteponline.com/books/definitions/page/cefr-level "CEFR Levels") for definition |
**Reading\_Level** | the iTEP level assigned to the Reading section **Valid values:** 0.0 - 6.0 |
**Reading\_Score** | the iTEP Test ID |
**Reading\_Percent** | the percent of correct answers for the Reading section **Valid values:** 0 - 100 |
**Reading\_cefr** | Reading CEFR level See [CEFR Levels](https://documentation.iteponline.com/books/definitions/page/cefr-level "CEFR Levels") for definition |
**Writing\_Level** | the iTEP level assigned to the Writing section **Valid values:** 0.0 - 6.0 |
**Writing\_Score** | the iTEP Test ID |
**Writing\_Percent** | the percent of correct answers for the Writing section **Valid values:** 0 - 100 |
**Writing\_cefr** | Writing CEFR level See [CEFR Levels](https://documentation.iteponline.com/books/definitions/page/cefr-level "CEFR Levels") for definition |
**Writing\_Question\_Count** | Number of questions in the writing section **NOTE: This is a numeric field** |
**Writing\_Question\_1** | As of 10/16/2024 this field will always contain a empty string |
**Writing\_Answer\_1** | As of 10/16/2024 this field will always contain a empty string |
**Writing\_Question\_2** | As of 10/16/2024 this field will always contain a empty string |
**Writing\_Answer\_2** | As of 10/16/2024 this field will always contain a empty string |
**Speaking\_Level** | the iTEP level assigned to the Speaking section **Valid values:** 0.0 - 6.0 |
**Speaking\_Score** | the iTEP Test ID |
**Speaking\_Percent** | the percent of correct answers for the Speaking section **Valid values:** 0 - 100 |
**Speaking\_cefr** | Speaking CEFR level See [CEFR Levels](https://documentation.iteponline.com/books/definitions/page/cefr-level "CEFR Levels") for definition |