get/application/{applicationId}/timeline
When a candidate applies to a job post an application identified by an unique code is created. This application may be associated to one or more TimeLine events. A TimeLine event is created every time the application undergoes a status change, for instance when the cv included in the application has been read by the company, or when the candidate is rejected from the application process. A request to this operation returns the application events associated to the applicationId provided for the authenticated user. By default the application events are returned ordered by descending update order.
Request
Resource URL
https://api.infojobs.net/api/3/application/{applicationId}/timeline
Security
- User Role: role_candidate
- Scope: application_timeline
Parameters
Name | Description |
---|---|
applicationId String Required |
Identifier of the application to retrieve for the authenticated user. Example values: 706280-6d45-483a-8327-d8c81b2ab |
page Integer Optional |
Used for pagination. Page to return. Default: 1. Example values: 2 |
pageSize Integer Optional |
Used for pagination. Number of results per page. Default value: 20. Allowed values: 10 | 20 | 30 Example values: 10 |
Response
Response fields
Name | Description |
---|---|
date Date |
The date of the last event of the job offer feed. Example value: 2011-05-31T09:09:20.000+0000 |
description String |
The event description. Maximum length: 200 |
initializer Boolean |
true if the event is the first of the current application process stage, false otherwise. |
finisher Boolean |
true if the event is the last of the current application process stage, false otherwise. |
rejectedReasons Array(String) |
Array with rejection reasons if present. |
Error codes
Code | Description |
---|---|
310 |
The page size page-size-value is not a valid parameter. |
Examples
This example gets the application events associated to the application provided for the authenticated user.
Request
GET https://api.infojobs.net/api/3/application/e2b9d78e-faaa-4dea-87bb-c4be00f1ba68/timeline
Response
{ "totalFound": 9, "events": [ { "tipoId": 11, "date": "2020-12-22T16:11:49.000+0000", "description": "La empresa ha gestionado CVs", "initializer": false, "finisher": false, "rejectedReasons": [] }, { "tipoId": 5, "date": "2020-10-23T10:02:10.000+0000", "description": "La empresa ha incluido tu candidatura entre las que siguen en el proceso", "initializer": false, "finisher": false, "rejectedReasons": [] }, { "tipoId": 3, "date": "2020-10-23T09:53:54.000+0000", "description": "La empresa ha leído tu CV ", "initializer": false, "finisher": false, "rejectedReasons": [] }, { "tipoId": 11, "date": "2020-10-23T09:53:54.000+0000", "description": "La empresa ha gestionado CVs", "initializer": false, "finisher": false, "rejectedReasons": [] }, { "tipoId": 3, "date": "2020-09-10T07:49:21.000+0000", "description": "La empresa ha leído tu CV ", "initializer": false, "finisher": false, "rejectedReasons": [] }, { "tipoId": 11, "date": "2020-09-10T07:49:21.000+0000", "description": "La empresa ha gestionado CVs", "initializer": false, "finisher": false, "rejectedReasons": [] }, { "tipoId": 5, "date": "2020-05-22T10:33:31.000+0000", "description": "La empresa ha incluido tu candidatura entre las que siguen en el proceso", "initializer": false, "finisher": false, "rejectedReasons": [] }, { "tipoId": 11, "date": "2020-05-22T10:33:31.000+0000", "description": "La empresa ha gestionado CVs", "initializer": false, "finisher": false, "rejectedReasons": [] }, { "tipoId": 1, "date": "2020-05-22T10:30:48.000+0000", "description": "Te has inscrito en la oferta", "initializer": true, "finisher": false, "rejectedReasons": [] } ] }