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

# Get expense

> Fetch one and only one expense for a user.



## OpenAPI

````yaml /openapi/findity-expense-api.json get /expenses/{expenseId}
openapi: 3.0.3
info:
  title: Findity Expense API
  description: Findity Expense API
  version: 1.0.0
servers:
  - url: https://stage-api.findity.com/api/v1/expense
  - url: https://api.findity.com/api/v1/expense
security:
  - bearerAuth: []
paths:
  /expenses/{expenseId}:
    get:
      tags:
        - Expenses
      summary: Get expense
      description: Fetch one and only one expense for a user.
      operationId: getExpense
      parameters:
        - $ref: '#/components/parameters/expenseId'
        - $ref: '#/components/parameters/expenseInclude'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExpenseRecord'
              examples:
                Receipt verification:
                  value:
                    receiptVerification:
                      value:
                        organizationId: ff808181963de13701963de1789d00ad
                        version: 2
                        lastUpdated: '2025-04-16T09:15:09Z'
                        dateCreated: '2025-04-16T09:15:09Z'
                        processStatus: DRAFT
                        status: NORMAL
                        expenseDate: '2023-03-21T10:58:14Z'
                        personId: ff808181963de13701963de177e00083
                        id: 5ca0dfa6def943eab46d240d3680c323
                        reimbursementCurrency: SEK
                        categoryId: 9ed4618ae74e4f17b69005f699c104f3
                        verification:
                          amount: 230
                          purchaseDate: '2023-03-21T10:58:14Z'
                          attachments:
                            - name: attachments2
                              isTemporary: false
                              id: ff808181963e296501963e29ac6d00be
                              contentType: image/jpeg
                            - name: attachments1
                              isTemporary: false
                              id: ff808181963e296501963e29ac5e00bc
                              contentType: image/jpeg
                          customFields:
                            - fieldDefinitionId: 2b965c866b634698811dabf45a491089,
                              value: true
                            - fieldDefinitionId: 59ljgfau904t3qio3aw90up34gj9iog4,
                              value: string
                            - fieldDefinitionId: 904t3qio3aw90up34gj9iog45a491089,
                              value: 10
                          description: verification-description
                          type: ReceiptVerification
                          lastUpdated: '2025-04-16T09:15:09Z'
                          dateCreated: '2025-04-16T09:15:09Z'
                          paymentTypeId: ed0d98d4e3834714bbca45f889d4584b
                          exchangeRate: 1
                          verificationNumber: verification-number
                          comment: verification-comment
                          currency: SEK
                          taxAmount: 23
                          receiptAttachment:
                            name: file-name607803656
                            personId: ff808181963de13701963de177e00083
                            isTemporary: false
                            id: ff808181963de13701963de179b900b9
                            contentType: image/png
                    receiptVerification with representation including guest list:
                      value:
                        organizationId: ff808181963e1df601963e2657bf01ec
                        lastUpdated: '2025-04-16T10:30:22Z'
                        dateCreated: '2025-04-16T10:30:22Z'
                        processStatus: DRAFT
                        personId: ff808181963e1df601963e26577201c2
                        id: 043c3ef85bea4e118adabbba4c3d16bf
                        reimbursementCurrency: SEK
                        categoryId: e59971ac44b54f2480d449b0d84caee2
                        status: NORMAL
                        expenseDate: '2023-03-21T10:58:14Z'
                        verification:
                          amount: 230
                          purchaseDate: '2023-03-21T10:58:14Z'
                          attachments:
                            - name: attachments2
                              isTemporary: false
                              id: ff808181963e296501963e29ac6d00be
                              contentType: image/jpeg
                            - name: attachments1
                              isTemporary: false
                              id: ff808181963e296501963e29ac5e00bc
                              contentType: image/jpeg
                          customFields:
                            - fieldDefinitionId: 2b965c866b634698811dabf45a491089,
                              value: true
                          description: verification-description
                          type: ReceiptVerification
                          lastUpdated: '2025-04-16T10:30:22Z'
                          dateCreated: '2025-04-16T10:30:22Z'
                          paymentTypeId: 253b87a3555a4c9bb288338131d2d83b
                          exchangeRate: 1
                          verificationNumber: verification-number
                          comment: verification-comment
                          currency: SEK
                          taxAmount: 23
                          receiptAttachment:
                            name: file-name1011137852
                            personId: ff808181963e1df601963e26577201c2
                            isTemporary: false
                            id: ff808181963e1df601963e26582601f8
                            contentType: image/png
                          representation:
                            includesLiquor: false
                            numberOfExternalGuests: 1
                            guests: []
                            numberOfGuests: 1
                            type: LUNCH
                            guestListAttached: true
                            guestListAttachment:
                              name: file-name386996737
                              personId: ff808181963e1df601963e26577201c2
                              isTemporary: false
                              id: ff808181963e1df601963e26583101f9
                              contentType: application/pdf
                    receiptVerification with representation including attached guests:
                      value:
                        organizationId: ff808181963e1df601963e1f931f014b
                        lastUpdated: '2025-04-16T10:22:59Z'
                        dateCreated: '2025-04-16T10:22:59Z'
                        processStatus: DRAFT
                        personId: ff808181963e1df601963e1f92d30121
                        id: 7c50f82edb7747bdb84f038e535f1e7d
                        reimbursementCurrency: SEK
                        categoryId: ebde877306a94f66a9b0695c7c48a43d
                        status: NORMAL
                        expenseDate: '2023-03-21T10:58:14Z'
                        verification:
                          amount: 230
                          purchaseDate: '2023-03-21T10:58:14Z'
                          attachments:
                            - name: attachments2
                              isTemporary: false
                              id: ff808181963e296501963e29ac6d00be
                              contentType: image/jpeg
                            - name: attachments1
                              isTemporary: false
                              id: ff808181963e296501963e29ac5e00bc
                              contentType: image/jpeg
                          customFields:
                            - fieldDefinitionId: 058d2a973694413db017b9e340f15d2d
                              value: '2023-01-01T01:00:00Z'
                          description: verification-description
                          type: ReceiptVerification
                          lastUpdated: '2025-04-16T10:22:59Z'
                          dateCreated: '2025-04-16T10:22:59Z'
                          paymentTypeId: 1f4d4253c7c740c7ae055d840d25392a
                          exchangeRate: 1
                          verificationNumber: verification-number
                          comment: verification-comment
                          currency: SEK
                          taxAmount: 23
                          receiptAttachment:
                            name: file-name985238297
                            personId: ff808181963e1df601963e1f92d30121
                            isTemporary: false
                            id: ff808181963e1df601963e1f93810157
                            contentType: image/png
                          representation:
                            includesLiquor: false
                            numberOfExternalGuests: 1
                            type: LUNCH
                            guestListAttached: false
                            guests:
                              - name: Person 1
                                company: Company A
                              - name: Person 2
                                company: Company B
                Car specification:
                  value:
                    carSpecification:
                      value:
                        organizationId: ff808181963e39cc01963e3a14250058
                        lastUpdated: '2025-04-16T10:52:48Z'
                        dateCreated: '2025-04-16T10:52:48Z'
                        processStatus: DRAFT
                        personId: ff808181963e39cc01963e3a119f002d
                        id: 67c18882083149599859054bcebb4ca0
                        reimbursementCurrency: SEK
                        categoryId: ec15a0b27286484e8e211447ecbe7fe8
                        status: NORMAL
                        expenseDate: '2023-09-13T11:46:27Z'
                        verification:
                          carType: PRIVATE_CAR
                          travelDate: '2023-09-13T11:46:27Z'
                          manualDistance: false
                          id: 729b4232c8ae4b6b83536195d9941f95
                          roundTrip: false
                          distanceUnit: KM
                          passengers: []
                          distance: 218
                          customFields: []
                          destination: Ludvika, Sverige - Stockholm, Sverige
                          description: Trip to Stockholm
                          type: CarSpecification
                          route:
                            - latitude: '60.1523510'
                              place: Ludvika, Sverige
                              longitude: '15.1919879'
                            - latitude: '59.3293481'
                              place: Stockholm, Sverige
                              longitude: '18.0682306'
                          tripDetails:
                            distanceOnGravel: 2
                            tollCost: 8
                            distanceWithTrailer: 4
                            distanceWithCaravan: 5
                            distanceInTransport: 1
                            distanceWithHeavyCaravan: 6
                            distanceWithDog: 7
                            numberOfPassengers: 3
                    carSpecification with specified passengers:
                      value:
                        organizationId: ff808181963e3f9e01963e44171a0097
                        lastUpdated: '2025-04-16T11:02:52Z'
                        dateCreated: '2025-04-16T11:02:52Z'
                        processStatus: DRAFT
                        personId: ff808181963e3f9e01963e44168a006c
                        id: 3cf0cfc4788e48c8b4ce299b82067734
                        reimbursementCurrency: SEK
                        categoryId: 738a68711bc64a8192970833770a19ba
                        status: NORMAL
                        expenseDate: '2023-09-13T11:46:27Z'
                        verification:
                          roundTrip: false
                          distanceUnit: KM
                          distance: 218
                          customFields: []
                          destination: Ludvika, Sverige - Stockholm, Sverige
                          description: Trip to Stockholm
                          type: CarSpecification
                          carType: PRIVATE_CAR
                          travelDate: '2023-09-13T11:46:27Z'
                          manualDistance: false
                          id: 9731f3e27a35456aa57c08b9893fed72
                          passengers:
                            - distance: 1
                              name: Albert
                            - distance: 2
                              name: Herbert
                            - distance: 3
                              name: Kyle
                            - distance: 4
                              name: Stephen
                          tripDetails:
                            distanceOnGravel: 2
                            tollCost: 8
                            distanceWithTrailer: 4
                            distanceWithCaravan: 5
                            distanceInTransport: 1
                            distanceWithHeavyCaravan: 6
                            distanceWithDog: 7
                            numberOfPassengers: 4
                          route:
                            - latitude: '60.1523510'
                              place: Ludvika, Sverige
                              longitude: '15.1919879'
                            - latitude: '59.3293481'
                              place: Stockholm, Sverige
                              longitude: '18.0682306'
                    carSpecificication with two via points in route:
                      value:
                        organizationId: ff808181963e39cc01963e3c2b160097
                        lastUpdated: '2025-04-16T10:54:13Z'
                        dateCreated: '2025-04-16T10:54:13Z'
                        processStatus: DRAFT
                        personId: ff808181963e39cc01963e3c2a60006c
                        id: 9a02ca26160a4dc4aeaab94393d2c6b2
                        reimbursementCurrency: SEK
                        categoryId: b2da3f3b1d96474da014e52b4681c095
                        status: NORMAL
                        expenseDate: '2023-09-13T11:46:27Z'
                        verification:
                          carType: PRIVATE_CAR
                          travelDate: '2023-09-13T11:46:27Z'
                          manualDistance: false
                          id: e9ce2d1f8dd94439afe52cc56598e226
                          roundTrip: false
                          distanceUnit: KM
                          passengers: []
                          distance: 218
                          customFields: []
                          destination: >-
                            Ludvika, Sverige - Falun - Borlänge - Stockholm,
                            Sverige
                          description: Trip to Stockholm
                          type: CarSpecification
                          route:
                            - latitude: '60.1523510'
                              place: Ludvika, Sverige
                              longitude: '15.1919879'
                            - latitude: '60.609036'
                              place: Falun
                              longitude: '15.629638'
                            - latitude: '60.489796'
                              place: Borlänge
                              longitude: '15.434664'
                            - latitude: '59.3293481'
                              place: Stockholm, Sverige
                              longitude: '18.0682306'
                          tripDetails:
                            distanceOnGravel: 2
                            tollCost: 8
                            distanceWithTrailer: 4
                            distanceWithCaravan: 5
                            distanceInTransport: 1
                            distanceWithHeavyCaravan: 6
                            distanceWithDog: 7
                            numberOfPassengers: 3
                    carSpecification with related fleet Management trip ids:
                      value:
                        organizationId: ff808181963e39cc01963e3d7e2800d6
                        lastUpdated: '2025-04-16T10:55:39Z'
                        dateCreated: '2025-04-16T10:55:39Z'
                        processStatus: DRAFT
                        personId: ff808181963e39cc01963e3d7dcd00ab
                        id: c52b9574c3cb449dad73426239595b4e
                        reimbursementCurrency: SEK
                        categoryId: 36339feeacf240ea9ff6246196377d2e
                        status: NORMAL
                        expenseDate: '2023-09-13T11:46:27Z'
                        verification:
                          travelDate: '2023-09-13T11:46:27Z'
                          manualDistance: false
                          id: d8a8f61fda724003a0ca787a0601fdf1
                          roundTrip: false
                          distanceUnit: KM
                          passengers: []
                          distance: 218
                          customFields: []
                          destination: Ludvika, Sverige - Stockholm, Sverige
                          description: Trip to Stockholm
                          type: CarSpecification
                          route:
                            - latitude: '60.1523510'
                              place: Ludvika, Sverige
                              longitude: '15.1919879'
                            - latitude: '59.3293481'
                              place: Stockholm, Sverige
                              longitude: '18.0682306'
                          carType: PRIVATE_CAR
                          relatedTrips:
                            - fleetManagementTripId: '1'
                            - fleetManagementTripId: '2'
                          tripDetails:
                            distanceOnGravel: 2
                            tollCost: 8
                            distanceWithTrailer: 4
                            distanceWithCaravan: 5
                            distanceInTransport: 1
                            distanceWithHeavyCaravan: 6
                            distanceWithDog: 7
                            numberOfPassengers: 3
                    carSpecification with toll cost data:
                      value:
                        organizationId: ff808181963e3f9e01963e3fde980058
                        lastUpdated: '2025-04-16T10:58:16Z'
                        dateCreated: '2025-04-16T10:58:16Z'
                        processStatus: DRAFT
                        personId: ff808181963e3f9e01963e3fdcaf002d
                        id: 3ef21fc73036472abe2035f8ea88a5ad
                        reimbursementCurrency: SEK
                        categoryId: bfb827510c7041c1a08a820721e7a934
                        status: NORMAL
                        expenseDate: '2023-09-13T11:46:27Z'
                        verification:
                          id: 16df71386a5f4652a02509d1a83d1081
                          roundTrip: false
                          distanceUnit: KM
                          passengers: []
                          tollCostFuelType: HYBRID
                          distance: 218
                          customFields: []
                          destination: Ludvika, Sverige - Stockholm, Sverige
                          description: Trip to Stockholm
                          type: CarSpecification
                          carType: PRIVATE_CAR
                          travelDate: '2023-09-13T11:46:27Z'
                          manualDistance: false
                          route:
                            - latitude: '60.1523510'
                              place: Ludvika, Sverige
                              longitude: '15.1919879'
                            - latitude: '59.3293481'
                              place: Stockholm, Sverige
                              longitude: '18.0682306'
                          tollCostData:
                            price: 100
                            returnPrice: 200
                            type: bompeng
                          tripDetails:
                            distanceOnGravel: 2
                            tollCost: 8
                            distanceWithTrailer: 4
                            distanceWithCaravan: 5
                            distanceInTransport: 1
                            distanceWithHeavyCaravan: 6
                            distanceWithDog: 7
                            numberOfPassengers: 3
                Subsistence allowance:
                  value:
                    id: de4f8d3d500645ef95f43497a1a81aef
                    status: NORMAL
                    processStatus: DRAFT
                    meta:
                      categoryIconUrl: >-
                        https://expense.findity.com/api/resources/8a49a1b359cbfe2a0159d563763c00d6
                      abbreviation:
                        iconUrl: >-
                          https://expense.findity.com/api/resources/8a49a1b359cbfe2a0159d563763c00d6
                        dateDescription: null
                        userDescription: null
                        expenseDescription: International statens satser
                        reimbursement: '834.6'
                        reimbursementDescription: 834.60 NOK
                        expenseType: SubsistenceAllowance
                        expenseTypeDescription: Subsistence allowance
                        alert: false
                    personId: 8ab28cb36b6a16a2016b6a1918eb0001
                    dateCreated: '2024-02-07T14:22:49Z'
                    lastUpdated: '2024-02-07T14:48:13Z'
                    organizationId: 8ab28c4e70f2fef90170f695b93e2158
                    categoryId: 237e9b8fc8fd4435b6d4efedcd581b59
                    expenseReportId: null
                    rejectComment: null
                    verification:
                      id: 0035aedff6d949bbab2ece3b6711d0a3
                      type: SubsistenceAllowance
                      customFields: null
                      description: null
                      accommodationType: PRIVATE
                      specifications:
                        - id: '208827'
                          destinationId: b4cb484990ea11e9838f465ec701a070
                          date1: 2024-02-01 13:30
                          date2: null
                          date1enabled: true
                          date2enabled: false
                        - id: '208828'
                          destinationId: b4cb484990ea11e9838f465ec701a070
                          date1: null
                          date2: 2024-02-03 11:00
                          date1enabled: false
                          date2enabled: true
                      deductions:
                        - id: '409480'
                          date: '2024-02-01T00:00:00Z'
                          isMealCompensation: false
                          accommodation: false
                          deductionTypeBreakfast: PAID_YOURSELF
                          deductionTypeLunch: PAID_YOURSELF
                          deductionTypeDinner: FOOD_IN_REPRESENTATION
                        - id: '409481'
                          date: '2024-02-02T00:00:00Z'
                          isMealCompensation: false
                          accommodation: false
                          deductionTypeBreakfast: PAID_YOURSELF
                          deductionTypeLunch: FOOD_IN_REPRESENTATION
                          deductionTypeDinner: PAID_YOURSELF
                    reimbursement: 834.6
                    reimbursementCurrency: NOK
                Food benefits specification:
                  value:
                    FoodBenefitsSpecification:
                      value:
                        organizationId: ff808181963e4c0201963e4c467400a7
                        lastUpdated: '2025-04-16T11:11:58Z'
                        dateCreated: '2025-04-16T11:11:58Z'
                        processStatus: DRAFT
                        personId: ff808181963e4c0201963e4c45be007d
                        id: 40c4e461fca947beb70822be9346bffa
                        reimbursementCurrency: SEK
                        status: NORMAL
                        expenseDate: '2025-04-16T11:11:48Z'
                        verification:
                          lastUpdated: '2025-04-16T11:11:58Z'
                          lunch: true
                          dateCreated: '2025-04-16T11:11:58Z'
                          validDate: '2025-04-16T11:11:48Z'
                          description: my fancy pancy description
                          id: 163c78165abf45eab3d52a65b9113e6f
                          type: FoodBenefitsSpecification
                          breakfast: true
                          dinner: true
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/404Error'
              example:
                result: error
                code: EXPENSE_RECORD_NOT_FOUND
                description: Expense not found
components:
  parameters:
    expenseId:
      in: path
      name: expenseId
      required: true
      description: The id of the expense to retrieve
      schema:
        $ref: '#/components/schemas/Uuid'
      example: da35f675f40e47bcae2fff3c43a94c73
    expenseInclude:
      name: include
      in: query
      description: optional properties to include
      required: false
      schema:
        $ref: '#/components/schemas/expenseIncludeEnum'
  schemas:
    ExpenseRecord:
      type: object
      description: ExpenseRecord format
      properties:
        id:
          type: string
          readOnly: true
        status:
          type: string
          enum:
            - NEW
            - NORMAL
            - APPROVAL
            - APPROVED
            - REJECTED
          readOnly: true
        personId:
          $ref: '#/components/schemas/Uuid'
          readOnly: true
        dateCreated:
          type: string
          readOnly: true
        lastUpdated:
          type: string
          readOnly: true
        version:
          type: integer
          format: int64
          description: >-
            Optimistic-lock counter, incremented on every update. On PUT, echo
            back the value from the last GET/PUT response to detect if the
            expense was changed by someone else since it was read; a mismatch
            returns 409. Optional; omit to skip this check.
        expenseDate:
          type: string
          readOnly: true
          description: >-
            Date that the user has selected for the expense. For receipt
            expenses it is purchase date. For mileages it is travel date and for
            per diems it is the first travel date.
        organizationId:
          $ref: '#/components/schemas/Uuid'
        categoryId:
          $ref: '#/components/schemas/Uuid'
        rejectComment:
          type: string
          readOnly: true
        reimbursement:
          type: number
          readOnly: true
        reimbursementCurrency:
          type: string
          readOnly: true
        meta:
          type: object
          readOnly: true
          properties:
            categoryIconUrl:
              type: string
              example: >-
                https://expense.findity.com/api/resources/8a5f867e9b204742a8cc2ca2b6c57358
            person:
              type: object
              properties:
                firstName:
                  type: string
                  example: Anna
                lastName:
                  type: string
                  example: Andersson
                email:
                  type: string
                  example: anna.andersson@example.com
            abbreviation:
              oneOf:
                - $ref: '#/components/schemas/ReceiptVerificationAbbreviation'
                - $ref: '#/components/schemas/CarSpecificationAbbreviation'
                - $ref: '#/components/schemas/SubsistenceAllowanceAbbreviation'
                - $ref: '#/components/schemas/FoodBenefitsSpecificationAbbreviation'
              discriminator:
                propertyName: expenseType
            capabilities:
              $ref: '#/components/schemas/Capabilities'
            cardTransaction:
              $ref: '#/components/schemas/CardTransactionMeta'
        verification:
          description: >-
            The expense-type-specific payload — receipt details, mileage
            details, per-diem details, or food-benefit details. Shape selected
            by the nested `type` discriminator.
          oneOf:
            - $ref: '#/components/schemas/ReceiptVerification'
            - $ref: '#/components/schemas/CarSpecification'
            - $ref: '#/components/schemas/SubsistenceAllowance'
            - $ref: '#/components/schemas/FoodBenefitsSpecification'
          discriminator:
            propertyName: type
        expenseReportId:
          $ref: '#/components/schemas/Uuid'
    404Error:
      type: object
      properties:
        result:
          type: string
        code:
          type: string
        description:
          type: string
    Uuid:
      type: string
      pattern: ^[0-9a-fA-F]{32}$
      description: UUID without dashes (32-character hex string)
    expenseIncludeEnum:
      type: array
      items:
        type: string
        enum:
          - verification
          - meta.abbreviation
          - meta.abbreviation.labels
          - meta.person
          - meta.capabilities
          - meta.cardTransaction
          - meta.splits
          - validationErrors
    ReceiptVerificationAbbreviation:
      type: object
      properties:
        iconUrl:
          type: string
          example: >-
            https://expense.findity.com/api/resources/ba479b6fe32f4d5e87e6dda1e02e850b
        dateDescription:
          type: string
          example: June 2, 2023
          description: Date formatted according to users locale
        sortDescription:
          type: string
          example: June 1, 2023
          description: Description of the value used for sorting
        userDescription:
          type: string
          example: Pens and erasers
        expenseDescription:
          type: string
          example: Office supplies
          description: Description which contains the name of category
        reimbursementDescription:
          type: string
          example: 44.5 SEK
          description: >-
            Reimbursement amount and currency formatted according to users
            locale
        totalReimbursementDescription:
          type: string
          example: 44.5 SEK
          description: >-
            Total reimbursement amount and currency formatted according to users
            locale, only included if requesting meta.splits and the expense is
            the parent
        alert:
          type: boolean
          description: >-
            If the report is rejected or contains expenses that has validation
            errors
        isComplete:
          type: boolean
          description: >-
            If the expense is complete and ready to be sent, can contain
            warnings.
        expenseType:
          type: string
          example: ReceiptVerification
        expenseTypeDescription:
          type: string
          description: description of expenseType property translated to the users language
    CarSpecificationAbbreviation:
      type: object
      properties:
        iconUrl:
          type: string
          example: >-
            https://expense.findity.com/api/resources/ba479b6fe32f4d5e87e6dda1e02e850b
        dateDescription:
          type: string
          example: June 2, 2023
          description: Date formatted according to users locale
        sortDescription:
          type: string
          example: June 1, 2023
          description: Description of the value used for sorting
        userDescription:
          type: string
          example: Trip to Ludvika
        expenseDescription:
          type: string
          example: Mileage - 273.0 km
          description: Description which contains the name of category
        alert:
          type: boolean
          description: >-
            If the report is rejected or contains expenses that has validation
            errors
        isComplete:
          type: boolean
          description: >-
            If the expense is complete and ready to be sent, can contain
            warnings.
        expenseType:
          type: string
          example: CarSpecification
        expenseTypeDescription:
          type: string
          description: >-
            description of expenseType property translated in the specific
            language
    SubsistenceAllowanceAbbreviation:
      type: object
      properties:
        iconUrl:
          type: string
          example: >-
            https://expense.findity.com/api/resources/ba479b6fe32f4d5e87e6dda1e02e850b
        dateDescription:
          type: string
          example: June 2, 2023
          description: Date formatted according to users locale
        sortDescription:
          type: string
          example: June 1, 2023
          description: Description of the value used for sorting
        userDescription:
          type: string
          example: Trip to Stockholm
        expenseDescription:
          type: string
          example: Domestic Subsistence Allowance
          description: Description which contains the name of category
        alert:
          type: boolean
          description: >-
            If the report is rejected or contains expenses that has validation
            errors
        isComplete:
          type: boolean
          description: >-
            If the expense is complete and ready to be sent, can contain
            warnings.
        expenseType:
          type: string
          example: SubsistenceAllowance
        expenseTypeDescription:
          type: string
          description: description of expenseType property translated to the users language
    FoodBenefitsSpecificationAbbreviation:
      type: object
      properties:
        iconUrl:
          type: string
          example: >-
            https://expense.findity.com/api/resources/ba479b6fe32f4d5e87e6dda1e02e850b
        dateDescription:
          type: string
          example: June 2, 2023
          description: Date formatted according to users locale
        sortDescription:
          type: string
          example: June 1, 2023
          description: Description of the value used for sorting
        userDescription:
          type: string
          example: Food benefit
        expenseDescription:
          type: string
          example: Food Benefits Specification
          description: Description which contains the name of category
        alert:
          type: boolean
          description: >-
            If the report is rejected or contains expenses that has validation
            errors
        isComplete:
          type: boolean
          description: >-
            If the expense is complete and ready to be sent, can contain
            warnings.
        expenseType:
          type: string
          example: FoodBenefitsSpecification
        expenseTypeDescription:
          type: string
          description: description of expenseType property translated to the users language
    Capabilities:
      type: object
      properties:
        canBeAddedToReport:
          type: boolean
          description: Indicates if the expense record can be added to a report
          example: false
        canBeRemovedFromReport:
          type: boolean
          description: Indicates if the expense record can be removed from a report
          example: false
        canBeDeleted:
          type: boolean
          description: Indicates if the expense record can be deleted
          example: true
        canBeSentIn:
          type: boolean
          example: true
          description: true if the expense record can be sent in directly without report
        canBeSplit:
          type: boolean
          description: Indicates if the expense record can be split
          example: false
        canBeEdited:
          type: boolean
          description: Indicates if the expense record can be edited
          example: true
        canBeMerged:
          type: boolean
          description: >-
            Indicates if the expense record can be merged with another expense
            record. Will only be true for expense records that are based on card
            transaction, has not been split and is editable by end user.
          example: false
        canAddBreakfast:
          type: boolean
          description: >-
            ONLY PART OF FoodBenefitsSpecifications! Indicates if breakfast is
            available for meal benefits.
          example: false
        canAddLunch:
          type: boolean
          description: >-
            ONLY PART OF FoodBenefitsSpecifications! Indicates if lunch is
            available for meal benefits.
          example: false
        canAddDinner:
          type: boolean
          description: >-
            ONLY PART OF FoodBenefitsSpecifications! Indicates if dinner is
            available for meal benefits.
          example: false
    CardTransactionMeta:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/Uuid'
          example: 4a17f93476ce4bf2832236be26743853
        amount:
          type: number
          format: double
          example: 120
        name:
          type: string
          example: Bank name
        cardNumber:
          type: string
          example: xxxxxxxxxxxx1234
    ReceiptVerification:
      allOf:
        - $ref: '#/components/schemas/Voucher'
        - type: object
          properties:
            type:
              type: string
              enum:
                - ReceiptVerification
            amount:
              type: number
            taxAmount:
              type: number
            tip:
              type: number
              format: double
              minimum: 0
              description: >
                The tip amount for the receipt, expressed as a non-negative
                decimal number in the receipt's currency. This is the canonical
                location for tip. For backwards compatibility the value is also
                mirrored on the deprecated `representation.tip` property.
            exchangeRate:
              type: number
            currency:
              type: string
            description:
              type: string
            purchaseDate:
              type: string
              format: date-time
            dateCreated:
              type: string
            lastUpdated:
              type: string
            storeName:
              type: string
            verificationNumber:
              type: string
            paymentTypeId:
              type: string
            cardTransactionId:
              type: string
            eventType:
              type: string
              enum:
                - AUTHORIZATION_ACCEPTED
                - AUTHORIZATION_REJECTED
                - AUTHORIZATION_REVERSAL
                - CAPTURE
                - REFUND
            receiptAttachment:
              $ref: '#/components/schemas/Content'
            representation:
              $ref: '#/components/schemas/Representation'
            attachments:
              type: array
              items:
                $ref: '#/components/schemas/Content'
            customFields:
              $ref: '#/components/schemas/ArrayOfCustomFields'
            taxRates:
              $ref: '#/components/schemas/ArrayOfTaxRates'
    CarSpecification:
      allOf:
        - $ref: '#/components/schemas/BusinessTrip'
        - type: object
          properties:
            carType:
              $ref: '#/components/schemas/CarTypeEnum'
            destination:
              type: string
              readOnly: true
            manualDistance:
              type: boolean
            tripDetails:
              type: object
              properties:
                distanceInTransport:
                  type: number
                distanceOnGravel:
                  type: number
                numberOfPassengers:
                  type: integer
                distanceWithTrailer:
                  type: number
                distanceWithCaravan:
                  type: number
                distanceWithHeavyCaravan:
                  type: number
                distanceWithDog:
                  type: number
                tollCost:
                  type: number
            relatedTrips:
              type: array
              items:
                type: object
                properties:
                  fleetManagementTripId:
                    $ref: '#/components/schemas/Uuid'
            tollCostFuelType:
              type: string
              enum:
                - PETROL
                - DIESEL
                - ELECTRIC
                - HYBRID
                - HYDROGEN
            tollCostData:
              type: object
              properties:
                returnDiscountedPrice:
                  type: number
                discountedPrice:
                  type: number
                price:
                  type: number
                returnPrice:
                  type: number
            passengers:
              type: array
              items:
                $ref: '#/components/schemas/Passenger'
            attachments:
              type: array
              items:
                $ref: '#/components/schemas/Content'
    SubsistenceAllowance:
      allOf:
        - $ref: '#/components/schemas/Voucher'
        - type: object
          properties:
            type:
              type: string
              enum:
                - SubsistenceAllowance
            amount:
              type: number
            taxAmount:
              type: number
            tip:
              type: number
            exchangeRate:
              type: number
            currency:
              type: string
            description:
              type: string
            purchaseDate:
              type: string
              format: date-time
            dateCreated:
              type: string
            lastUpdated:
              type: string
            storeName:
              type: string
            verificationNumber:
              type: string
            paymentTypeId:
              type: string
            cardTransactionId:
              type: string
            eventType:
              type: string
              enum:
                - AUTHORIZATION_ACCEPTED
                - AUTHORIZATION_REJECTED
                - AUTHORIZATION_REVERSAL
                - CAPTURE
                - REFUND
            receiptAttachment:
              $ref: '#/components/schemas/Content'
            representation:
              $ref: '#/components/schemas/Representation'
            attachments:
              type: array
              items:
                $ref: '#/components/schemas/Content'
            customFields:
              $ref: '#/components/schemas/ArrayOfCustomFields'
    FoodBenefitsSpecification:
      allOf:
        - $ref: '#/components/schemas/Voucher'
        - type: object
          properties:
            type:
              type: string
              enum:
                - FoodBenefitsSpecification
            description:
              type: string
            breakfast:
              type: boolean
            lunch:
              type: boolean
            dinner:
              type: boolean
            customFields:
              $ref: '#/components/schemas/ArrayOfCustomFields'
    Voucher:
      allOf:
        - $ref: '#/components/schemas/Document'
        - type: object
          properties:
            reimbursement:
              type: number
            comment:
              type: string
    Content:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/Uuid'
        personId:
          $ref: '#/components/schemas/Uuid'
        contentType:
          type: string
        isTemporary:
          type: boolean
        signatureType:
          type: string
          enum:
            - EU
        signatureUrl:
          type: string
        name:
          type: string
        description:
          type: string
        qrScan:
          type: string
          description: >-
            Decoded fiscal QR string as sent in the `qrScan` request header on
            POST. Omitted when the resource has no QR data attached. Currently
            populated for Portuguese receipts.
        scanResult:
          type: object
          readOnly: true
          properties:
            id:
              $ref: '#/components/schemas/Uuid'
            amount:
              type: number
              format: double
            taxAmount:
              type: number
              format: double
            currency:
              type: string
            purchaseDate:
              type: string
            categoryIds:
              type: array
              items:
                $ref: '#/components/schemas/Uuid'
            categoryId:
              $ref: '#/components/schemas/Uuid'
      example:
        id: 62bfaa54dc9341819cd6f4ff4ae39f44
        personId: 063ee3c7fa4b4728b418097299447f9d
        contentType: application/pdf
        isTemporary: true
        signatureType: null
        signatureUrl: null
        name: receipt-photo.jpg
        description: Receipt photo
        qrScan: >-
          A:514482621*B:501878076*C:PT*D:FR*E:N*F:20260508*G:111
          26A/154*H:J6Z9V4MR-154*I1:PT-MA*I7:68.50*I8:15.76*N:15.76*O:84.26*Q:T4Fn*R:116
        scanResult:
          id: a185160800524ac68cbf0a18ad59649b
          amount: 135
          taxAmount: 23
          currency: SEK
          purchaseDate: '2023-04-20'
          categoryIds:
            - 575ba2572de74f38b947a07df93a2909
            - 350dadb020694421aebc1d9473fa64a9
          categoryId: 575ba2572de74f38b947a07df93a2909
    Representation:
      type: object
      properties:
        type:
          type: string
        guestListAttached:
          type: boolean
          default: false
        includesLiquor:
          type: boolean
          default: false
        numberOfGuests:
          type: integer
        numberOfExternalGuests:
          type: integer
        place:
          type: string
        tip:
          type: number
          format: double
          minimum: 0
          deprecated: true
          description: >
            Deprecated. Tip is now a root receipt verification property (`tip`).
            A non-negative decimal number in the receipt's currency. This
            property is kept for backwards compatibility and mirrors the root
            value.
        guestListAttachment:
          $ref: '#/components/schemas/Content'
        guests:
          type: array
          items:
            $ref: '#/components/schemas/Guest'
    ArrayOfCustomFields:
      type: array
      items:
        type: object
        properties:
          fieldDefinitionId:
            $ref: '#/components/schemas/Uuid'
          value:
            $ref: '#/components/schemas/AnyValue'
    ArrayOfTaxRates:
      type: array
      items:
        type: object
        properties:
          taxRateId:
            $ref: '#/components/schemas/Uuid'
          rate:
            type: number
            format: double
          taxAmount:
            type: number
            format: double
    BusinessTrip:
      allOf:
        - $ref: '#/components/schemas/Voucher'
        - type: object
          properties:
            type:
              type: string
              enum:
                - CarSpecification
            distance:
              type: number
            distanceUnit:
              type: string
              enum:
                - KM
                - MILES
              readOnly: true
            travelDate:
              type: string
              format: date-time
            description:
              type: string
            roundTrip:
              type: boolean
            route:
              type: array
              items:
                $ref: '#/components/schemas/PlaceWithCoords'
            customFields:
              $ref: '#/components/schemas/ArrayOfCustomFields'
    CarTypeEnum:
      type: string
      enum:
        - PRIVATE_CAR
        - COMPANY_CAR
        - COMPANY_CAR_DIESEL
        - COMPANY_CAR_OTHER
        - COMPANY_CAR_ELECTRICITY
        - COMPANY_CAR_ELECTRICITY_HOME
        - COMPANY_CAR_ELECTRICITY_PUBLIC
        - COMPANY_CAR_LTE_1400CC_PETROL
        - COMPANY_CAR_LTE_1400CC_LPG
        - COMPANY_CAR_LTE_1600CC_DIESEL
        - COMPANY_CAR_1401_2000CC_PETROL
        - COMPANY_CAR_1401_2000CC_LPG
        - COMPANY_CAR_1601_2000CC_DIESEL
        - COMPANY_CAR_GT_2000CC_PETROL
        - COMPANY_CAR_GT_2000CC_LPG
        - COMPANY_CAR_GT_2000CC_DIESEL
        - MOTOR_CYCLE
        - MOTOR_CYCLE_GT_125CC
        - MOTOR_CYCLE_LTE_125CC
        - MOPED
        - ALL_TERRAIN_VEHICLE
        - SNOW_MOBILE
        - BOAT_WITH_ENGINE
        - BOAT_WITH_ENGINE_GT_50HK
        - BOAT_WITH_ENGINE_LTE_50HK
        - PRIVATE_CAR_OR_MOTOR_CYCLE
        - PRIVATE_CYCLE_OR_MOPED
        - OTHER_VEHICLE
        - MOPED_OR_SCOOTER
        - CYCLE_OR_WALKING
        - PUBLIC_TRANSPORTATION
        - PRIVATE_CAR_3HP_LESS
        - PRIVATE_CAR_4HP
        - PRIVATE_CAR_5HP
        - PRIVATE_CAR_6HP
        - PRIVATE_CAR_7HP_MORE
        - MOTOR_CYCLE_1_2HP
        - MOTOR_CYCLE_3_5HP
        - MOTOR_CYCLE_5HP_MORE
        - PRIVATE_CAR_COMMUTER_HOME
    Passenger:
      type: object
      properties:
        name:
          type: string
        distance:
          type: number
          format: double
    Document:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/Uuid'
          readOnly: true
    Guest:
      type: object
      properties:
        name:
          type: string
        company:
          type: string
    AnyValue:
      description: 'Can be: string, number, integer, date, boolean'
    PlaceWithCoords:
      type: object
      properties:
        place:
          type: string
          example: Ludvika, Sverige
        latitude:
          type: string
          example: '60.1523510'
        longitude:
          type: string
          example: '15.1919879'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````