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

# Get the expense transactions.



## OpenAPI

````yaml api-reference/openapi.json get /api/expenses
openapi: 3.0.0
info:
  title: Bigcapital
  description: Financial accounting software
  version: '1.0'
  contact: {}
servers: []
security: []
tags: []
paths:
  /api/expenses:
    get:
      tags:
        - Expenses
      summary: Get the expense transactions.
      operationId: ExpensesController_getExpenses
      parameters:
        - name: Authorization
          in: header
          description: >-
            Value must be 'Bearer <token>' where <token> is an API key prefixed
            with 'bc_' or a JWT token.
          required: true
          schema:
            type: string
            example: Bearer bc_1234567890abcdef
        - name: organization-id
          in: header
          description: >-
            Required if Authorization is a JWT token. The organization ID to
            operate within.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: The item list has been successfully retrieved.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/PaginatedResponseDto'
                  - properties:
                      data:
                        type: array
                        items:
                          $ref: '#/components/schemas/ExpenseResponseDto'
components:
  schemas:
    PaginatedResponseDto:
      type: object
      properties:
        pagination:
          description: Pagination metadata
          allOf:
            - $ref: '#/components/schemas/Pagination'
      required:
        - pagination
    ExpenseResponseDto:
      type: object
      properties:
        id:
          type: number
          example: 1
          description: The unique identifier of the expense
        totalAmount:
          type: number
          example: 1000
          description: The total amount of the expense
        currencyCode:
          type: string
          example: USD
          description: The currency code of the expense
        exchangeRate:
          type: number
          example: 1.2
          description: The exchange rate used for the expense
        description:
          type: string
          example: Office supplies and equipment
          description: The description of the expense
        paymentAccountId:
          type: number
          example: 1
          description: The ID of the payment account used for this expense
        referenceNo:
          type: string
          example: EXP-2024-001
          description: The reference number of the expense
        publishedAt:
          format: date-time
          type: string
          example: '2024-03-20T10:00:00Z'
          description: The date when the expense was published
        userId:
          type: number
          example: 1
          description: The ID of the user who created the expense
        paymentDate:
          format: date-time
          type: string
          example: '2024-03-20T10:00:00Z'
          description: The payment date of the expense
        payeeId:
          type: number
          example: 1
          description: The ID of the payee
        landedCostAmount:
          type: number
          example: 800
          description: The landed cost amount of the expense
        allocatedCostAmount:
          type: number
          example: 200
          description: The allocated cost amount of the expense
        invoicedAmount:
          type: number
          example: 0
          description: The invoiced amount of the expense
        branchId:
          type: number
          example: 1
          description: The ID of the branch associated with the expense
        createdAt:
          format: date-time
          type: string
          example: '2024-03-20T10:00:00Z'
          description: The creation date of the expense
        isPublished:
          type: boolean
          example: true
          description: Whether the expense is published
        unallocatedCostAmount:
          type: number
          example: 200
          description: The unallocated cost amount of the expense
        localAmount:
          type: number
          example: 1200
          description: The local amount of the expense (total amount * exchange rate)
        localLandedCostAmount:
          type: number
          example: 960
          description: The local landed cost amount of the expense
        localAllocatedCostAmount:
          type: number
          example: 240
          description: The local allocated cost amount of the expense
        localUnallocatedCostAmount:
          type: number
          example: 240
          description: The local unallocated cost amount of the expense
        billableAmount:
          type: number
          example: 1000
          description: The billable amount of the expense
        categories:
          description: The categories associated with this expense
          type: array
          items:
            $ref: '#/components/schemas/ExpenseCategoryResponseDto'
      required:
        - id
        - totalAmount
        - currencyCode
        - exchangeRate
        - paymentAccountId
        - referenceNo
        - userId
        - paymentDate
        - payeeId
        - landedCostAmount
        - allocatedCostAmount
        - invoicedAmount
        - branchId
        - createdAt
        - isPublished
        - unallocatedCostAmount
        - localAmount
        - localLandedCostAmount
        - localAllocatedCostAmount
        - localUnallocatedCostAmount
        - billableAmount
        - categories
    Pagination:
      type: object
      properties:
        total:
          type: number
          description: Total number of items across all pages
          example: 100
        page:
          type: number
          description: Current page number (1-based)
          example: 1
          minimum: 1
        pageSize:
          type: number
          description: Number of items per page
          example: 10
          minimum: 1
      required:
        - total
        - page
        - pageSize
    ExpenseCategoryResponseDto:
      type: object
      properties:
        id:
          type: number
          example: 1
          description: The unique identifier of the expense category
        amount:
          type: number
          example: 100
          description: The amount of the expense category
        allocatedCostAmount:
          type: number
          example: 50
          description: The allocated cost amount of the expense category
        expenseAccountId:
          type: number
          example: 1
          description: The expense account ID associated with this category
        projectId:
          type: number
          example: 1
          description: The project ID associated with this category
        description:
          type: string
          example: Office supplies for Q1
          description: The description of the expense category
        unallocatedCostAmount:
          type: number
          example: 50
          description: The unallocated cost amount of the expense category
      required:
        - id
        - amount
        - allocatedCostAmount
        - expenseAccountId
        - description
        - unallocatedCostAmount

````