« Back to operation list

get/application

When a candidate applies to a job post, an application identified by an unique code is created. A request to this operation returns the newest 20 applications to job offers for the authenticated user. By default the applications are returned ordered by "last-event" (in descending order).

Request

Resource URL

https://api.infojobs.net/api/5/application

Security

  • User Role: role_candidate
  • Scope: my_applications

Parameters

NameDescription

hideRejected

Boolean

Optional

Hide rejected application if true, default: false.

Example values: true

pageSize

Integer

Optional

Used for pagination. Number of results per page. Default value: 20.

Allowed values: 10 | 20 | 30

Example values: 10

page

Integer

Optional

Used for pagination. Page number to return. Default: 1.

Example values: 3

order

String

Optional

Order in which the results will be shown. Default: application-date.

Allowed values: application-date | last-event

Example values: last-event

Response

Response fields

Fields related to the result
NameDescription

totalFound

Integer

The total number of applications found for this candidate.

applications

Array(Applications)

The list of applications, see below for details.

Fields related to Application entity
NameDescription

date

Date

The application date.

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

code

String

The application unique identifier.

Maximum length: 100

rejected

Boolean

true if the application has been rejected by the company, false otherwise.

processClosed

Boolean

true if the application process has ended, false otherwise.

offerRemoved

Boolean

true if the job offer related to the application has been removed, false otherwise.

eventsReadpending

Integer

The number of unread events.

lastEvent

TimelineEvent

The last event in the application feed, see TimelineEvent definition below, for details.

cvReceivedEvent

TimelineEvent

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

cvReadEvent

TimelineEvent

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

inProcessEvent

TimelineEvent

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

processClosedEvent

TimelineEvent

A specific event in the application feed indicating that the application process has been closed, see TimelineEventdefinition below, for details.

offerRemovedEvent

TimelineEvent

A specific event in the application feed indicating that the job offer related to the application has been removed, see TimelineEvent definition below, for details.

jobOffer

JobOffer

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

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

List rejection reasons if present.

Maximum String length: 50

Fields related to JobOffer entity
NameDescription

code

String

The job offer unique identifier.

Maximum length: 100

title

String

The job offer title.

Maximum length: 150

city

String

The city where the job offer is listed.

Maximum length: 200

company

String (100)

The name of the company posting the job offer.

Maximum length: 100

Error codes

CodeDescription

305

The order (order-value) is not a valid parameter

306

The page (page-value) is not a valid parameter.

310

The page size (page-size-value) is not a valid parameter.

Examples

This example gets the applications for the authenticated user.

Request

GET https://api.infojobs.net/api/5/application

Response

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

Sections: