> ## Documentation Index
> Fetch the complete documentation index at: https://docs.veridox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Finding Locations Setting

> Check whether page locations are returned with your organisation's analyses.

Returns whether [Get File Analysis](https://docs.veridox.ai/api-reference/endpoints/files-analysis-get.md#page-locations) returns page locations on evidence, and the `key_terms` block, for your organisation's analyses. The setting is off by default, so `enabled` is `false` until someone switches it on with [Update Finding Locations Setting](https://docs.veridox.ai/api-reference/endpoints/org-finding-locations-update.md).

## Permission

Requires `organisation_settings:read`, which the Owner and Admin roles hold by default. A caller without it receives `403`.

## Related

* [Update Finding Locations Setting](https://docs.veridox.ai/api-reference/endpoints/org-finding-locations-update.md) switches the setting on or off.
* [Get File Analysis](https://docs.veridox.ai/api-reference/endpoints/files-analysis-get.md#page-locations) describes the page locations the setting controls.


## OpenAPI

````yaml GET /organisations/features/finding-locations
openapi: 3.1.0
info:
  title: Veridox Core API
  description: Veridox Core Platform API
  version: 0.0.1
  contact: {}
servers:
  - url: https://api.uk.veridox.ai
    description: Live (UK)
  - url: https://api.ca.veridox.ai
    description: Live (CA)
  - url: https://api.eu.veridox.ai
    description: Live (EU)
security: []
tags:
  - name: Status
    description: System status and health check endpoints
  - name: Authentication
    description: Authentication status of the calling credential
  - name: Cases
    description: Case management
  - name: Case Files
    description: Case file uploads, downloads and analysis results
  - name: Organisations
    description: Organisation management
  - name: Users
    description: The calling user's profile
  - name: Document Requests
    description: Document request management
  - name: Search
    description: Search functionality
paths:
  /organisations/features/finding-locations:
    get:
      tags:
        - Organisations
      summary: Get finding location settings
      description: >-
        Returns whether page locations on evidence and the key_terms block are
        returned with the organisation's analyses. Defaults to disabled when
        nothing has been saved. The setting applies to every analysis when it is
        read, including analyses made before it changed. Requires
        organisation_settings:read.
      operationId: FindingLocationSettingsController_getSettings
      parameters: []
      responses:
        '200':
          description: Finding location settings retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FindingLocationSettingsResponseDto'
        '401':
          description: Unauthorized (invalid or missing authentication token)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
        '403':
          description: Caller lacks organisation_settings:read
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
        '429':
          description: Too many requests (rate limit exceeded)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
      security:
        - api-key: []
components:
  schemas:
    FindingLocationSettingsResponseDto:
      type: object
      properties:
        enabled:
          type: boolean
      required:
        - enabled
    ErrorDto:
      type: object
      properties:
        error_code:
          type: string
          description: Machine-readable error code for programmatic handling
          examples:
            - request.cases.file.missing-risk-score
            - request.authentication.invalid-token
            - request.forbidden
            - request.cases.case.not-found
            - request.cases.case.already-locked
        error_message:
          type: string
          description: Human-readable error message explaining what went wrong
          example: >-
            User tried to perform an invalid operation on a file without a risk
            score.
        error_details:
          type: object
          example:
            field: email_address
      required:
        - error_code
        - error_message
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.