# 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: [![image.png](https://documentation.iteponline.com/uploads/images/gallery/2024-08/scaled-1680-/KBEdxAzcpCWN5Qhl-image.png)](https://documentation.iteponline.com/uploads/images/gallery/2024-08/KBEdxAzcpCWN5Qhl-image.png) ##### Data sent: [![image.png](https://documentation.iteponline.com/uploads/images/gallery/2024-08/scaled-1680-/7Zpnd7bjOUnZayn3-image.png)](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.
**Results detail such as scores and the score report URL are returned ONLY when a test has passed all technical and integrity reviews and is given a completed status by the iTEP academics department.**
##### Specific Field Detail: ##### General Fields Always included:
**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 Section Fields:
**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 Section Fields:
**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 Section Fields:
**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 Section Fields:
**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 Section Fields:
**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