> ## 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. # List expense records attached to expense report for approval > Returns the expense records inside an expense report, in the approver's view — restricted to records the calling approver has authority over. ## OpenAPI ````yaml openapi/findity-expense-api.json GET /me/organizations/{id}/approvals/{expenseReportId}/expenses 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: /me/organizations/{id}/approvals/{expenseReportId}/expenses: get: tags: - Approvals summary: List expense records attached to expense report for approval description: >- Returns the expense records inside an expense report, in the approver's view — restricted to records the calling approver has authority over. operationId: listExpenseApprovals parameters: - $ref: '#/components/parameters/organizationId' - $ref: '#/components/parameters/expenseReportId' - $ref: '#/components/parameters/approvalChainId' - $ref: '#/components/parameters/expenseInclude' - $ref: '#/components/parameters/max' - $ref: '#/components/parameters/offset' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfExpenseRecords' '404': description: Error content: application/json: schema: $ref: '#/components/schemas/404Error' example: result: error code: EXPENSE_RECORD_NOT_FOUND description: Expenses not found components: parameters: organizationId: in: path name: id required: true description: The id of the organization of the user schema: $ref: '#/components/schemas/Uuid' example: 05b8daba9ba14a49846fe77883248cf0 expenseReportId: in: path name: expenseReportId required: true description: Id of the expense report. schema: $ref: '#/components/schemas/Uuid' example: da35f675f40e47bcae2fff3c43a94c73 approvalChainId: in: query name: approvalChainId description: >- The approval chain id to filter expense records included in the expense report required: true schema: type: string format: id example: 99546 expenseInclude: name: include in: query description: optional properties to include required: false schema: $ref: '#/components/schemas/expenseIncludeEnum' max: name: max in: query description: max records to return required: false schema: type: integer format: int minimum: 1 maximum: 1000 default: 10 offset: name: offset in: query description: the offset to be used in list required: false schema: type: integer format: int minimum: 0 default: 0 schemas: ArrayOfExpenseRecords: type: object properties: meta: properties: count: type: integer total: type: integer data: type: array items: $ref: '#/components/schemas/ExpenseRecord' example: meta: count: 10 total: 242 data: [] 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 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' 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 ````