get/application/{applicationId}

When a candidate applies to a job post an application identified by an unique code is created. A request to this operation returns the application identified by the application id specified in the URL for the authenticated user.


Request

Resource URL

https://api.infojobs.net/api/1/application/{applicationId}

Security

  • User Role: role_candidate
  • Scope: my_applications

Parameters

Name Description

applicationId

Required

String

Identifier of the application to retrieve for the authenticated user.

Example values: 706285-6d45-483a-8327-d8c81b0a62

Response

Response fields

Fields related to Application entity
Name Description

date

Date

The application date.

Example value: 2011-05-31T09:09:20.000+0000

code

String

The application unique identifier.

Maximum length: 100

cv

String

Name of the CV associated to the user application.

Maximum length: 100

hasCoverLetter

Boolean

true if the application has a cover letter selected, false otherwise.

rejected

Boolean

true if the application is rejected, false otherwise.

offerRemoved

Boolean

true if the offer is removed, false otherwise.

processClosed

Boolean

true if the selection proccess has ended, false otherwise.

eventsReadpending

Integer

The number of unread events.

inProcessEvent

TimelineEvent

A specific event in the application feed indicating that the user application has been included in the selection process, see below for details.

cvReadEvent

TimelineEvent

A specific event in the application feed indicating that the user CV has been read for this application, see below for details.

offerRemovedEvent

TimelineEvent

A specific event in the application feed indicating that the offer is removed, see below for details.

processClosedEvent

TimelineEvent

A specific event in the application feed indicating that the selection process for this offer has ended, see below for details.

cvReceivedEvent

TimelineEvent

A specific event in the application feed indicating that the user CV has been received for this application, see below for details.

jobOffer

JobOffer

The job offer the candidate applied to, see below for details.

Fields related to an TimelineEvent entity
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: 50

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 the rejection reasons if present.

Maximum String length: 50

Fields related to JobOffer entity
Name Description

code

String

The job offer unique identifier.

Maximum length: 100

title

String

The job offer title.

Maximum String length: 150

company

String

The job offer company name.

Maximum length: 100

province

ShortDictionaryItem

The province of the job offer, see below for details.

city

String

The job offer city.

Maximum length: 100

applications

Long

Number of applications received for the job post.

Fields related to a ShortDictionaryItem entity
Name Description

id

Integer

Identifier of the dictionary item.

value

String

Human readable textual value.

Maximum length: 100

Error codes

Code Description

321

The application (applicationId) is not a valid parameter.

Examples

This example retrieves the application with the id: 1e8d8ce6-95f1-4bd5-b9df-9cee360f0e3f for the authenticated user.

Request

GET https://api.infojobs.net/api/1/application/1e8d8ce6-95f1-4bd5-b9df-9cee360f0e3f

Response

{
   "hasCoverLetter": false,
   "cv": "Jose",
   "code": "25e51c3e-95b3-40be-8391-2df326c6fxxx",
   "date": "2020-05-22T10:30:48.000+0000",
   "eventsReadPending": -1,
   "rejected": false,
   "offerRemoved": false,
   "processClosed": false,
   "jobOffer": {
       "title": "Ingeriero de Software con Ruso",
       "company": "Ingeniería Fernández",
       "city": "Terradillos De Esgueva",
       "code": "793313858f4fcaac90e5ac9622cxxx",
       "applications": 2,
       "province": {
           "id": 10,
           "value": "Burgos"
       }
   },
   "cvReadEvent": {
       "date": "2020-09-10T07:49:21.000+0000",
       "description": "La empresa ha leído tu CV ",
       "initializer": false,
       "finisher": false,
       "rejectedReasons": []
   },
   "cvReceivedEvent": {
       "date": "2020-05-22T10:30:48.000+0000",
       "description": "Te has inscrito en la oferta",
       "initializer": true,
       "finisher": false,
       "rejectedReasons": []
   },
   "inProcessEvent": {
       "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": []
   }
}