> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.spott.io/llms.txt > Use this file to discover all available pages before exploring further. # List applications > Returns a list of applications. Uses cursor pagination. ## OpenAPI ````yaml /openapi-private.json get /applications openapi: 3.1.0 info: title: Spott API Reference version: '0.1' servers: - url: https://api.gospott.com security: [] tags: [] paths: /applications: get: tags: - Applications summary: List applications description: Returns a list of applications. Uses cursor pagination. operationId: getApplicationsCursorPaginated parameters: - name: cursor required: false in: query description: >- Base64-encoded cursor for pagination. Use the cursor value from a previous response to fetch the next page. Omit for the first page. schema: type: string - name: modifiedSince required: false in: query description: >- ISO 8601 datetime string to filter applications modified on or after this date. If omitted, returns all applications from the beginning of time. schema: $ref: '#/components/schemas/DateISO' default: '1970-01-01T00:00:00.000Z' example: '2024-01-01T00:00:00.000Z' - name: modifiedUntil required: false in: query description: >- ISO 8601 datetime string to filter applications by sync watermark on or before this date. Useful for incremental syncing with a fixed upper bound. schema: $ref: '#/components/schemas/DateISO' example: '2024-12-31T23:59:59.999Z' - name: limit required: false in: query schema: minimum: 1 maximum: 50 type: number - name: vacancyIds required: false in: query schema: type: array items: type: string - name: candidateEmailAddresses required: false in: query schema: minItems: 1 maxItems: 25 uniqueItems: true example: - candidate@example.com type: array items: type: string format: email pattern: >- ^(([^<>()\[\]\\.,;:\s@"]+(\.[^<>()\[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$ - name: isInbound required: false in: query description: Filter by whether the application is inbound (true) or not (false). schema: type: boolean - name: include required: false in: query description: >- Optional related resources to include in the response. Allowed values: lastActivity, candidate.latestWorkExperience, candidate.locations, candidate.emailAddresses, candidate.phoneNumbers, vacancy.clientContactTeam, vacancy.jobBoards. schema: uniqueItems: true example: - vacancy.jobBoards type: array items: type: string enum: - lastActivity - candidate.latestWorkExperience - candidate.locations - candidate.emailAddresses - candidate.phoneNumbers - vacancy.clientContactTeam - vacancy.jobBoards responses: '200': description: >- Successfully retrieved applications. Returns items array with pagination info containing cursor for the next page. content: application/json: schema: $ref: '#/components/schemas/GetApplicationsCursorPaginatedResponseDto' '400': description: >- Bad request - invalid query parameters (e.g., limit out of range, invalid date format) content: application/json: schema: allOf: - $ref: '#/components/schemas/ExceptionBaseDto' - type: object properties: statusCode: type: number example: 400 message: type: string example: Limit must be between 1 and 50 error: type: string example: Bad Request '401': description: Unauthorized - invalid or missing authentication content: application/json: schema: $ref: '#/components/schemas/ExceptionBaseDto' '500': description: Error response content: application/json: schema: $ref: '#/components/schemas/ExceptionBaseDto' security: - x-api-key: [] components: schemas: DateISO: id: DateISO format: date-time anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ - type: string format: date pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ GetApplicationsCursorPaginatedResponseDto: type: object properties: items: type: array items: $ref: '#/components/schemas/ApplicationSearchItemDto' pagination: $ref: '#/components/schemas/ApplicationCursorPaginationDto' required: - items - pagination id: PrivateGetApplicationsCursorPaginatedResponseDto ExceptionBaseDto: type: object properties: status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 message: type: string requestId: type: string required: - status - message - requestId id: ExceptionBaseDto ApplicationSearchItemDto: type: object properties: id: type: string minLength: 1 position: type: number description: >- Non-bounded float defining the position of an application within its stage. createdAt: $ref: '#/components/schemas/DateISO' candidate: $ref: '#/components/schemas/ApplicationCandidateBadgeDto' vacancy: anyOf: - $ref: '#/components/schemas/ApplicationVacancyBadgeDto' - type: 'null' stage: $ref: '#/components/schemas/ApplicationStageBaseDto' required: - id - position - createdAt - candidate - vacancy - stage id: PrivateApplicationSearchItemDto ApplicationCursorPaginationDto: type: object properties: cursor: anyOf: - type: object properties: modifiedAt: $ref: '#/components/schemas/DateISO' id: type: string required: - modifiedAt - id - type: 'null' type: - string - 'null' hasMore: type: boolean deprecated: true description: >- Use the cursor presence to identify if there are more results to fetch instead. This property will be removed in a future release required: - cursor - hasMore id: PrivateApplicationCursorPaginationDto ApplicationCandidateBadgeDto: type: object properties: id: type: string minLength: 1 firstName: type: string lastName: type: string middleName: anyOf: - type: string - type: 'null' secondLastName: anyOf: - type: string - type: 'null' avatarUrl: anyOf: - type: string - type: 'null' required: - id - firstName - lastName - middleName - secondLastName - avatarUrl id: PrivateApplicationCandidateBadgeDto ApplicationVacancyBadgeDto: type: object properties: id: type: string minLength: 1 name: type: string companyId: type: string minLength: 1 companyName: type: string companyLogoUrl: anyOf: - type: string - type: 'null' jobBoards: type: array items: $ref: '#/components/schemas/ApplicationJobBoardDto' required: - id - name - companyId - companyName - companyLogoUrl id: PrivateApplicationVacancyBadgeDto ApplicationStageBaseDto: type: object properties: id: type: string minLength: 1 order: type: number name: type: string colorHex: type: string required: - id - order - name - colorHex id: PrivateApplicationStageBaseDto ApplicationJobBoardDto: type: object properties: id: type: string minLength: 1 required: - id id: PrivateApplicationJobBoardDto securitySchemes: x-api-key: type: apiKey name: x-api-key in: header description: >- API key for authentication. Get your API key from Settings → API Keys in your Spott dashboard. ````