> ## 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.

# V0 - List Reports (externalId)

> Returns the expense reports in the given organization.



## OpenAPI

````yaml openapi/findity-admin-api-1.json GET /organizations/externalid/{externalId}/expensereports/
openapi: 3.0.3
info:
  title: Findity Admin API
  description: ''
  version: 1.0.0
  contact:
    name: Findity Support
    email: support@findity.com
servers:
  - url: https://stage-expense.findity.com/api/admin
    description: Stage environment
  - url: https://expense.findity.com/api/admin
    description: Production environment
security:
  - bearerAuth: []
paths:
  /organizations/externalid/{externalId}/expensereports/:
    get:
      tags:
        - Reports
      summary: V0 - List Reports (externalId)
      description: Returns the expense reports in the given organization.
      operationId: 35ad2968-c199-466c-b801-300d11f8c1ef
      parameters:
        - $ref: '#/components/parameters/externalId'
        - name: includeExpenseRecords
          in: query
          description: >-
            When `true`, attached expense records are inlined on each report;
            default `false` returns header-level fields only.
          schema:
            type: string
            default: ''
        - name: max
          in: query
          description: Page size (default platform pagination max).
          schema:
            type: string
            default: ''
        - name: offset
          in: query
          schema:
            type: string
            default: ''
          description: Pagination offset, zero-based.
        - name: onlyFtg
          in: query
          description: >-
            When `true`, restricts the result to reports auto-generated from an
            invoice (FTG). Only meaningful when `statuses` is `NEW` or `NORMAL`.
          schema:
            type: string
            default: ''
        - name: statuses
          in: query
          description: >-
            Lifecycle statuses to include. Comma-separated or repeated. Default
            covers the active set (NEW, NORMAL, TRANSFER, TRANSFER_TO_RECIPIENT,
            SEND, SENT, APPROVAL, APPROVED, REJECTED, ERROR, PAID,
            READY_TO_SEND).
          schema:
            type: string
            default: NEW
        - name: X-Findity-ApiVersion
          in: header
          schema:
            type: string
            default: '3'
            description: Findity API version. Use `3` for the current admin API.
      responses:
        '200':
          description: OK
          content:
            application/json:
              example:
                meta:
                  max: 10
                  offset: 0
                  total: 2
                  count: 2
                reports:
                  - id: f328e47d595c40ad80f27f52626c5b92
                    name: Expense Report May 2026
                    status: APPROVAL
                    dateCreated: '2026-05-02T08:15:30Z'
                    lastUpdated: '2026-05-14T11:42:18Z'
                    totalAmount: 4287.5
                    totalAmountCurrency: SEK
                    reportNumber: ER-2026-0512
                    ownerId: a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
                  - id: b4d28a193f5e4ac1a0e6a39f17c0e2b8
                    name: Travel Report April 2026
                    status: PAID
                    dateCreated: '2026-04-18T07:02:11Z'
                    lastUpdated: '2026-04-30T15:11:55Z'
                    totalAmount: 1840
                    totalAmountCurrency: SEK
                    reportNumber: ER-2026-0418
                    ownerId: a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
        '400':
          description: Bad request
          content:
            application/json:
              example:
                result: error
                description: Input validation failed
components:
  parameters:
    externalId:
      in: path
      name: externalId
      required: true
      description: The external source id of the organization
      schema:
        type: string
      example: 6aeb86c4fb154c46b2b5a1977245ac67
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````