> ## Documentation Index > Fetch the complete documentation index at: https://docs.spirii.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Expense ## OpenAPI ````yaml /openapi/reimbursement/expenses/openapi.yaml get /v1/expenses/{expenseId} openapi: 3.0.3 info: title: Reimbursement description: API for managing reimbursement expenses. version: '1.0' servers: - url: https://api.spirii.com/reimbursement security: - BearerAuth: [] tags: - name: Reimbursement Expenses description: Operations related to expense reimbursement. paths: /v1/expenses/{expenseId}: get: tags: - Reimbursement Expenses summary: Get Expense operationId: getExpenseDetails parameters: - $ref: '#/components/parameters/expenseId_path' responses: '200': description: >- Returns a single expense with a list of charging details records (CDRs). content: application/json: schema: $ref: '#/components/schemas/ExpenseDetails' default: $ref: '#/components/responses/ProblemDetail' components: parameters: expenseId_path: name: expenseId required: true in: path description: Unique identifier of the Expense. schema: type: string format: uuid example: f570bb7a-180a-4f82-bc13-eedf3573de43 schemas: ExpenseDetails: allOf: - $ref: '#/components/schemas/ExpenseItem' - type: object properties: cdrList: type: array description: Charging sessions (CDRs) associated with this expense. items: $ref: '#/components/schemas/ChargeDetailRecord' required: - cdrList ExpenseItem: type: object properties: amountInCents: type: number description: >- Total reimbursement amount for this expense, in the smallest currency unit (e.g. cents). authIdTag: $ref: '#/components/schemas/AuthIdTag' consumptionInWattHours: type: number description: >- Total energy consumed across all charging sessions linked to this expense, in watt-hours. currency: type: string description: ISO 4217 currency code for the reimbursement amount. example: EUR IBAN: type: string description: >- IBAN of the recipient's bank account used for the reimbursement transfer. example: DK9520000123456789 id: type: string format: uuid description: Unique identifier of the expense. paymentStatus: $ref: '#/components/schemas/ExpensePaymentStatus' period: $ref: '#/components/schemas/Period' recipientName: type: string example: John Doe description: Name of the recipient. recipientCrmId: type: integer description: Spirii ID of the recipient. example: 123456 recipientExternalId: type: string description: External ID of the recipient (Your ID). example: testExternalId reportStatus: $ref: '#/components/schemas/ExpenseReportStatus' required: - amountInCents - consumptionInWattHours - currency - IBAN - id - recipientName - recipientCrmId - reportStatus ChargeDetailRecord: type: object properties: amountInCents: type: number nullable: true description: >- Cost of this charging session, in the smallest currency unit (e.g. cents). authIdTag: $ref: '#/components/schemas/AuthIdTag' consumedInWattHours: type: number nullable: true description: Energy consumed during this charging session, in watt-hours. chargingTime: type: object description: Duration of the charging session. properties: days: type: integer nullable: true hours: type: integer nullable: true minutes: type: integer nullable: true seconds: type: integer nullable: true nullable: true customerName: type: string nullable: true description: Name of the App User. example: John Doe endedAt: type: string format: date-time nullable: true description: End time of the transaction. locationName: type: string nullable: true description: Given name of the charging location. centsPerWh: type: number nullable: true description: Agreement or Reimbursement rate in cents per Wh. startedAt: type: string format: date-time nullable: true description: Start time of the transaction. tagIdLabel: deprecated: true type: string nullable: true description: >- Label of the authentication token. This is often printed on the physical token. transactionId: type: integer description: Spirii ID of the transaction. Also shared with the charger. required: - transactionId ProblemDetail: type: object description: RFC 9457 problem details. properties: type: type: string example: about:blank description: >- A URI reference that identifies the problem type. When this member is not present, its value is assumed to be "about:blank". format: uri title: example: Bad Request description: >- A short, human-readable summary of the problem type. It should not change from occurrence to occurrence of the problem, except for purposes of localization. type: string status: example: 400 description: >- The HTTP status code generated by the origin server for this occurrence of the problem. type: integer detail: example: Invalid request body description: >- A human-readable explanation specific to this occurrence of the problem. type: string instance: example: /v1/uri-called/ description: >- A URI reference that identifies the specific occurrence of the problem. type: string format: uri-reference errors: example: - currentPage must be a positive integer description: >- Optional field containing additional error details, such as validation errors. type: array items: type: string required: - type - title - status - detail - instance AuthIdTag: type: object properties: uid: type: string description: >- UID of the authentication token. This is what the charger uses to authorise. label: type: string nullable: true description: >- Label of the authentication token. This is often printed on the physical token. billingReference: type: string nullable: true description: Additional billing reference on the token. ExpensePaymentStatus: type: string description: Status of an expense payment. enum: - Awaiting funds - Failed - In progress - Not started - Paid x-enum-varnames: - Awaiting funds - Failed - In progress - Not started - Paid x-enum-descriptions: - >- The Expense Report has been approved but the payment transfer has not yet executed. - Payment transfer failed. - Payment transfer is currently being processed. - >- The Expense Report has not been approved yet; payment has not been initiated. - Payment transfer has been completed successfully. Period: type: object description: Month of the most recent expense in the report. properties: year: type: integer description: Calendar year of the period. example: 2026 monthIndex: type: integer minimum: 0 maximum: 11 description: A number between 0 and 11 (January to December). example: 0 required: - year - monthIndex ExpenseReportStatus: type: string description: Status of the Expense Report. enum: - Active - Pending - Approved - FundsReceived x-enum-varnames: - Active - Pending - Approved - FundsReceived x-enum-descriptions: - Current month's expense report. - Expense Report ready to be approved. - Expense Report has been approved, but not yet paid for. - Expense Report has been finalized (approved and paid for). responses: ProblemDetail: description: >- An error occurred. Returns a response body conforming to [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457). content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' securitySchemes: BearerAuth: scheme: bearer bearerFormat: JWT description: Authorization via a JWT bearer token. type: http ````