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

# Get accounts

> Retrieve reported accounts with their representatives by account number.



## OpenAPI

````yaml get /reports/sask/v1/accounts
openapi: 3.1.0
info:
  title: OpenAPI definition
  version: v0
servers:
  - url: https://api.rrc.dev.finventi.com
    description: Development
  - url: https://api.rrc.finventi.com
    description: Production
security:
  - bearer-jwt: []
tags:
  - name: MMR-SASK Push API
    description: >-
      REST API for submitting MMR-SASK accounts, representatives, and
      beneficiaries
paths:
  /reports/sask/v1/accounts:
    get:
      tags:
        - MMR-SASK Push API
      summary: Retrieve reported accounts with their representatives
      description: >-
        Looks up accounts previously reported to the Lithuanian tax authority
        (VMI) by account number and returns each account together with its
        representatives and their refIds. If the account was reported in several
        currencies, a separate entry is returned for each currency. Returns an
        empty list if no reported account matches the account number.
      operationId: getAccounts
      parameters:
        - name: accountNumber
          in: query
          description: Account number
          required: true
          schema:
            type: string
          example: LT601010012345678901
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SaskAccountResponse'
components:
  schemas:
    SaskAccountResponse:
      type: object
      properties:
        accountType:
          $ref: '#/components/schemas/AccountType'
        iban:
          type: string
          description: Account number (IBAN)
          example: LT601010012345678901
          maxLength: 35
          minLength: 0
        currency:
          type: string
          description: Currency code (ISO 4217)
          example: EUR
          minLength: 1
        openedDate:
          type: string
          format: date
          description: Date when the account was opened
          example: '2024-12-20'
        closedDate:
          type: string
          format: date
          description: Date when the account was closed
          example: '2025-06-30'
        owner:
          $ref: '#/components/schemas/Person'
        refId:
          type: string
          description: >-
            Unique reference ID of the account. Store it for future updates or
            deletions
          example: 305697289_20250303_E5D11991C7B74CB0
        representatives:
          type: array
          description: List of representatives for this account
          items:
            $ref: '#/components/schemas/SaskRepresentativeResponse'
      required:
        - accountType
        - currency
        - iban
        - openedDate
        - owner
        - refId
    AccountType:
      type: string
      enum:
        - CURRENT_ACCOUNT
        - DEPOSIT_ACCOUNT
        - LOAN_ACCOUNT
        - SAVINGS_ACCOUNT
        - PAYMENT_CARD_ACCOUNT
        - OTHER_ACCOUNT
        - SECURITIES_ACCOUNT
        - CUSTODY_ACCOUNT
        - SMALL_ENTREPRENEUR_ACCOUNT
        - INVESTMENT_ACCOUNT
        - CRYPTO_ASSET_ACCOUNT
    Person:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/CustomerType'
          description: 'Customer type: F - natural person, J - legal person, K - other'
        personCode:
          type: string
          description: >-
            Person code (up to 11 digits): legal entity code from the Register
            of Legal Entities, natural person code from the Population Register,
            or taxpayer identification number assigned by VMI
          example: 39001011234
          pattern: ^[0-9]{0,11}$
          maxLength: 11
        name:
          type: string
          description: First name. Required for natural persons
          example: Jonas
          maxLength: 120
          minLength: 0
        surname:
          type: string
          description: Last name or company name
          example: Jonaitis
          maxLength: 120
          minLength: 0
        birthDate:
          type: string
          format: date
          description: Date of birth
          example: '1990-05-15'
        addressCountry:
          type: string
          description: Address country code (ISO 3166-1 alpha-2)
          example: LT
        address:
          type: string
          description: Full address in free form
          example: Vilnius, Gedimino pr. 1
          maxLength: 240
          minLength: 0
        codeCountry:
          type: string
          description: Country code of identification document (ISO 3166-1 alpha-2)
          example: LT
        codeInForeignCountry:
          type: string
          description: Foreign country issued personal identification code
          example: 39001011234
          maxLength: 30
          minLength: 0
        documentType:
          $ref: '#/components/schemas/DocumentType'
        documentNumber:
          type: string
          description: Document number
          example: AB123456
          maxLength: 30
          minLength: 0
        nationalities:
          type: array
          description: List of nationality country codes (ISO 3166-1 alpha-2)
          example:
            - LT
          items:
            type: string
        siv:
          type: boolean
          description: >-
            Simplified identity verification flag (VMI attribute STN): true -
            simplified customer identity verification applied, false - not
            applied, omitted - not specified. When true, "Document Type",
            "Document Number" and "Code Country" become optional for non-LT
            natural persons; instead "Birth Date" and complete address ("Address
            Country", "Address") or "Birth Date" and "Nationalities" are
            required
          example: false
      required:
        - surname
        - type
    SaskRepresentativeResponse:
      type: object
      properties:
        dateFrom:
          type: string
          format: date
          description: Date from which the representative is valid
          example: '2024-12-18'
        dateTo:
          type: string
          format: date
          description: Date until which the representative is valid
          example: '2025-12-31'
        representative:
          $ref: '#/components/schemas/Person'
        refId:
          type: string
          description: >-
            Unique reference ID of the representative. Store it for future
            updates or deletions
          example: cc85a01c-e710-4a72-bed1-df29c2d90f23
      required:
        - dateFrom
        - refId
        - representative
    CustomerType:
      type: string
      enum:
        - F
        - J
        - K
    DocumentType:
      type: string
      enum:
        - LT_PASSPORT
        - BIRTH_CERTIFICATE
        - DRIVERS_LICENSE
        - LT_PERMANENT_RESIDENCE_PERMIT
        - LT_TEMPORARY_RESIDENCE_PERMIT
        - LT_ID_CARD
        - NON_LT_PASSPORT
        - DIPLOMATIC_PASSPORT
        - NON_LT_ID_CARD
        - EU_RESIDENCE_PERMIT
        - LT_DIGITAL_TEMPORARY_RESIDENCE_PERMIT
  securitySchemes:
    bearer-jwt:
      type: oauth2
      description: 'Obtain JWT via client_credentials grant. Required role: MMR_SASK_REPORT'
      flows:
        clientCredentials:
          tokenUrl: >-
            http://localhost:8180/realms/sti-connector/protocol/openid-connect/token
          scopes:
            MMR_SASK_REPORT: Submit MMR-SASK reports

````