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

NameDescription

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

Fields related to Event entity
NameDescription

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

CodeDescription

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": []
       }
   ]
}