> ## 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 report > Returns a single expense report owned by the calling user. ## OpenAPI ````yaml openapi/findity-expense-api.json GET /expensereports/{expenseReportId} 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: /expensereports/{expenseReportId}: get: tags: - Expense Reports summary: Get expense report description: Returns a single expense report owned by the calling user. operationId: getExpenseReport parameters: - $ref: '#/components/parameters/expenseReportId' - $ref: '#/components/parameters/expenseReportInclude' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ExpenseReport' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/404Error' example: result: error code: EXPENSE_REPORT_NOT_FOUND description: Expense report not found components: parameters: expenseReportId: in: path name: expenseReportId required: true description: Id of the expense report. schema: $ref: '#/components/schemas/Uuid' example: da35f675f40e47bcae2fff3c43a94c73 expenseReportInclude: name: include in: query description: >- Optional properties to include. Expense records optional data can be included by extending the expenseRecords include keyword with the available optional parameters from the List expenses endpoint. E.g. expenseRecords.verification, expenseRecords.meta.abbreviation, expenseRecords.meta.splits etc. required: false schema: allOf: - $ref: '#/components/schemas/splitsIncludeEnum' - $ref: '#/components/schemas/expenseRecordIncludeEnum' - $ref: '#/components/schemas/expenseReportIncludeEnum' schemas: ExpenseReport: type: object properties: comment: type: string dateCreated: type: string readOnly: true emailRecipients: type: string expenseRecords: type: array items: $ref: '#/components/schemas/ExpenseRecord' id: type: string version: type: integer format: int64 description: >- Optimistic-lock counter, incremented on every update. Echo this value back in the request body of a PUT to detect if the report was changed by someone else since it was read; a mismatch returns 409. lastUpdated: type: string meta: type: object properties: abbreviation: $ref: '#/components/schemas/ExpenseReportAbbreviation' violations: $ref: '#/components/schemas/ExpenseReportViolations' approval: $ref: '#/components/schemas/ExpenseReportApproval' requirements: $ref: '#/components/schemas/ExpenseReportRequirements' messages: $ref: '#/components/schemas/ExpenseReportMessages' invoice: $ref: '#/components/schemas/ExpenseReportInvoice' capabilities: $ref: '#/components/schemas/ExpenseReportCapabilities' name: type: string organizationId: $ref: '#/components/schemas/Uuid' personId: $ref: '#/components/schemas/Uuid' previewUrl: type: string readOnly: true reportNumber: type: string sent: type: string readOnly: true status: type: string enum: - APPROVAL - APPROVED - READY_TO_SEND - BULK_TRANSFER - ERROR - NEW - NORMAL - PAID - REJECTED - SEND - SENT - TRANSFER - TRANSFER_TO_RECIPIENT readOnly: true processStatus: type: string enum: - DRAFT - PROCESSING - PROCESSED - REJECTED readOnly: true reimbursement: type: number readOnly: true reimbursementCurrency: type: string readOnly: true approvalChainId: type: string readOnly: true type: type: string enum: - AUTOMATIC - MANUAL - COMPANY_CARD readOnly: true customFields: $ref: '#/components/schemas/ArrayOfCustomFields' 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) splitsIncludeEnum: type: array items: type: string enum: - expenseRecords.meta.splits expenseRecordIncludeEnum: type: array items: type: string enum: - expenseRecords.verification - expenseRecords.meta.abbreviation - expenseRecords.meta.abbreviation.labels - expenseRecords.meta.person - expenseRecords.meta.capabilities - expenseRecords.meta.cardTransaction expenseReportIncludeEnum: type: array items: type: string enum: - meta.abbreviation - meta.violations - meta.approval - meta.messages - meta.invoice - meta.capabilities - expenseRecords 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' ExpenseReportAbbreviation: type: object properties: alert: type: boolean description: >- If the report is rejected or contains expenses that has validation errors approvalComment: type: string dateDescription: type: string sortDescription: type: string iconUrl: type: string reimbursementDescription: type: string example: 44.5 SEK description: >- Reimbursement amount and currency formatted according to users locale userDescription: type: string labels: type: array description: List of labels for the expense report items: $ref: '#/components/schemas/ExpenseLabel' ExpenseReportViolations: type: array items: type: object properties: type: type: string enum: - DUPLICATE level: type: string enum: - INFO - WARNING - BLOCKER handledComment: type: string violatedExpenseIds: type: array description: List of expense record ids items: type: string ExpenseReportApproval: type: object properties: rejectedExpenseRecordIds: type: array description: List of expense record ids items: type: string ExpenseReportRequirements: type: object properties: approval: $ref: '#/components/schemas/ExpenseReportApprovalRequirements' ExpenseReportMessages: type: array items: type: object properties: message: type: string date: type: string ExpenseReportInvoice: type: object properties: cardIconUrl: type: string invoiceRef: type: string invoiceNumber: type: string bank: type: string dueDate: type: string invoiceDate: type: string liability: type: string enum: - corporate ExpenseReportCapabilities: type: object properties: canBeDeleted: type: boolean description: Indicates if the expense report could be deleted or not example: true canBeRetracted: type: boolean description: >- Indicates if the expense report can be retracted. A report can only be retracted if it is in APPROVAL status and no expense records or approval chain instances have been approved yet example: false canBeSentIn: type: boolean description: Indicates if the expense report can be sent in by end user example: true canBeEdited: type: boolean description: Indicates if the expense report can be edited in by end user example: true canRemoveExpenses: type: boolean description: >- Indicates if expense records that are attached to/included in the report can be removed. This is set to false if the report is in processStatus = REJECTED or if it is corporate card expense report canAddExpenses: type: boolean description: >- Indicates if expense records that are not attached to/excluded from the report can be added. This is set to false if the report is in processStatus = REJECTED or if it is corporate card expense report ArrayOfCustomFields: type: array items: type: object properties: fieldDefinitionId: $ref: '#/components/schemas/Uuid' value: $ref: '#/components/schemas/AnyValue' 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' ExpenseLabel: type: object description: Label for an expense or expense report properties: property: type: string description: The property this label relates to example: label.autoApproval text: type: string description: The label text to display example: Auto-approved priority: type: string enum: - NORMAL - IMPORTANT - CRITICAL description: Priority level of the label example: NORMAL type: type: string enum: - NORMAL - SUCCESS - INFORMATION - WARNING - ERROR description: Type of label indicating its semantic meaning example: SUCCESS iconUrl: type: string description: Optional URL to an icon for the label example: https://expense.findity.com/api/resources/ic_ai_sparkles.svg ExpenseReportApprovalRequirements: type: object properties: requireNextStepApprovers: type: boolean readOnly: true nextStepApprovers: type: string nullable: true readOnly: true AnyValue: description: 'Can be: string, number, integer, date, boolean' 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' 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 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 ````