Skip to main content
GET
/
applications
/
{id}
Get application
curl --request GET \
  --url https://api.gospott.com/applications/{id} \
  --header 'x-api-key: <api-key>'
{
  "candidateApplicationType": "speculativeApplication",
  "id": "<string>",
  "stage": {
    "type": "speculative",
    "templateType": "DEFAULT_SPECULATIVE",
    "viewType": "applicationStage",
    "id": "<string>",
    "name": "<string>",
    "order": 123,
    "status": {
      "id": "<string>",
      "name": "<string>",
      "colorHex": "<string>"
    },
    "colorHex": "<string>",
    "templateId": "<string>"
  },
  "owner": {
    "viewType": "applicationOwner",
    "owner": {
      "id": "<string>",
      "name": "<string>",
      "avatarUrl": "<string>",
      "deactivatedAt": "2023-11-07T05:31:56Z"
    }
  },
  "applicationState": {
    "state": "for-review",
    "viewType": "<string>"
  },
  "placements": [
    {
      "id": "<string>",
      "templateId": "<string>",
      "placedByUser": {
        "id": "<string>",
        "name": "<string>",
        "avatarUrl": "<string>",
        "deactivatedAt": "2023-11-07T05:31:56Z"
      },
      "placedAt": "2023-11-07T05:31:56Z",
      "startDate": "2023-11-07T05:31:56Z",
      "endDate": "2023-11-07T05:31:56Z",
      "grossFee": {
        "amount": 10000,
        "currency": "EUR"
      },
      "netFee": {
        "amount": 10000,
        "currency": "EUR"
      }
    }
  ],
  "commentCount": 123,
  "latestActivity": {
    "type": "applicationCreated",
    "isInbound": true,
    "date": "2023-11-07T05:31:56Z",
    "triggeredByUser": {
      "id": "<string>",
      "name": "<string>",
      "avatarUrl": "<string>",
      "deactivatedAt": "2023-11-07T05:31:56Z"
    }
  },
  "client": {
    "viewType": "<string>",
    "client": {
      "industry": "Accessible Architecture and Design",
      "size": "1 employee",
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "domain": "<string>",
      "logoUrl": "<string>"
    }
  },
  "clientTeam": {
    "viewType": "<string>",
    "clientTeam": [
      {
        "id": "<string>",
        "firstName": "<string>",
        "lastName": "<string>",
        "middleName": "<string>",
        "secondLastName": "<string>",
        "avatarUrl": "<string>",
        "candidateId": "<string>",
        "companyId": "<string>",
        "companyName": "<string>",
        "companyLogoUrl": "<string>"
      }
    ]
  },
  "vacancy": {
    "viewType": "applicationVacancy",
    "id": "<string>",
    "title": "<string>",
    "description": "<string>",
    "location": {
      "type": "primary_home",
      "street1": "<string>",
      "street2": "<string>",
      "postalCode": "<string>",
      "city": "<string>",
      "region": "<string>",
      "state": "<string>",
      "country": "<string>",
      "rawCityCountry": "<string>",
      "latitude": 123,
      "longitude": 123,
      "formattedAddress": "<string>"
    },
    "client": {
      "industry": "Accessible Architecture and Design",
      "size": "1 employee",
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "domain": "<string>",
      "logoUrl": "<string>"
    },
    "stage": {
      "id": "<string>",
      "order": 123,
      "name": "<string>",
      "colorHex": "<string>",
      "isOpen": true
    }
  },
  "comments": [
    {
      "id": "<string>",
      "content": "<string>",
      "canEdit": true,
      "createdBy": {
        "id": "<string>",
        "name": "<string>",
        "avatarUrl": "<string>",
        "deactivatedAt": "2023-11-07T05:31:56Z"
      },
      "createdAt": "2023-11-07T05:31:56Z",
      "modifiedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "interviews": [
    {
      "id": "<string>",
      "startTime": "2023-11-07T05:31:56Z",
      "endTime": "2023-11-07T05:31:56Z",
      "title": "<string>",
      "meetingId": "<string>"
    }
  ],
  "candidateMeetings": [
    {
      "showAs": "FREE",
      "id": "<string>",
      "meetingProvider": "googleMeet",
      "title": "<string>",
      "participants": [
        {
          "contact": {
            "type": "candidate",
            "currentWorkExperience": {
              "title": "<string>",
              "company": {
                "id": "<string>",
                "name": "<string>",
                "logoUrl": "<string>"
              }
            },
            "firstName": "<string>",
            "middleName": "<string>",
            "lastName": "<string>",
            "avatarUrl": "<string>",
            "id": "<string>"
          },
          "name": "<string>",
          "email": "<string>"
        }
      ],
      "startTime": "2023-11-07T05:31:56Z",
      "endTime": "2023-11-07T05:31:56Z",
      "isRecurringSeries": true,
      "recurringSeriesId": "<string>",
      "onlineJoinUrl": "<string>",
      "hasBot": true,
      "isAllDay": true
    }
  ],
  "candidate": {
    "lastInteractionWith": {
      "id": "<string>",
      "name": "<string>",
      "avatarUrl": "<string>",
      "deactivatedAt": "2023-11-07T05:31:56Z"
    },
    "lastInteractionDate": "2023-11-07T05:31:56Z",
    "emails": [
      {
        "purpose": "personal",
        "email": "jsmith@example.com",
        "isPrimary": true
      }
    ],
    "id": "<string>",
    "firstName": "<string>",
    "lastName": "<string>",
    "middleName": "<string>",
    "secondLastName": "<string>",
    "avatarUrl": "<string>"
  },
  "rejection": {
    "rejectedByEntity": "CLIENT",
    "applicationId": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "modifiedAt": "2023-11-07T05:31:56Z",
    "reason": "<string>",
    "rejectionLabels": [
      {
        "id": "<string>",
        "name": "<string>",
        "colorHex": "<string>"
      }
    ],
    "id": "<string>",
    "rejectedByUser": {
      "id": "<string>",
      "name": "<string>",
      "avatarUrl": "<string>",
      "deactivatedAt": "2023-11-07T05:31:56Z"
    }
  },
  "internalTeam": {
    "viewType": "<string>",
    "internalTeam": [
      {
        "id": "<string>",
        "name": "<string>",
        "avatarUrl": "<string>",
        "deactivatedAt": "2023-11-07T05:31:56Z"
      }
    ]
  },
  "notes": {
    "viewType": "<string>",
    "notes": [
      {
        "noteId": "<string>",
        "title": "<string>",
        "createdAt": "2023-11-07T05:31:56Z"
      }
    ]
  },
  "freeText": "<string>"
}

Authorizations

​
x-api-key
string
header
required

API key for authentication. Get your API key from Settings → API Keys in your Spott dashboard.

Path Parameters

​
id
string
required

Response

Successfully retrieved application details

​
candidateApplicationType
enum<string>
required

Type of application: standard (linked to a job) or speculative (linked directly to a Company without Job)

Available options:
speculativeApplication,
standardApplication
​
id
string
required

Unique identifier for the application

​
stage
object
required

Current pipeline stage of the application

​
owner
object
required

Owner/recruiter responsible for this application

​
applicationState
object
required

Current state of the application (active, rejected, etc.)

​
placements
object[]
required

Placements resulting from this application

​
commentCount
number
required

Number of comments on this application

​
latestActivity
object
required

Most recent activity on this application

​
client
object
required

Company associated with this application

​
clientTeam
object
required

Company Contacts involved with this application

​
vacancy
object
required

Job this application is for (null for speculative applications)

​
comments
object[]
required
​
interviews
object[]
required
​
candidateMeetings
object[]
required
​
candidate
object
required
​
rejection
object
required
​
internalTeam
object
required
​
notes
object
required
​
freeText
string | null
required