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

> Retrieve reported beneficiaries by company code.



## OpenAPI

````yaml get /reports/sask/v1/beneficiaries
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/beneficiaries:
    get:
      tags:
        - MMR-SASK Push API
      summary: Retrieve reported beneficiaries by company code
      description: >-
        Looks up beneficiaries previously reported to the Lithuanian tax
        authority (VMI) under the given company code and returns them with their
        refIds. Returns an empty list if no reported beneficiary matches the
        company code.
      operationId: getBeneficiaries
      parameters:
        - name: companyCode
          in: query
          description: Company code the beneficiaries were reported under
          required: true
          schema:
            type: string
          example: 302641851
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SaskBeneficiaryResponse'
components:
  schemas:
    SaskBeneficiaryResponse:
      type: object
      properties:
        codeInForeignCountry:
          type: string
          description: Foreign country issued legal entity identification code
          example: 305697289
          maxLength: 30
          minLength: 0
        name:
          type: string
          description: Legal entity name
          example: UAB Inventi
          maxLength: 120
          minLength: 0
        dateFrom:
          type: string
          format: date
          description: Date from which the beneficiary relationship is valid
          example: '2024-12-18'
        dateTo:
          type: string
          format: date
          description: Date until which the beneficiary relationship is valid
          example: '2025-12-31'
        country:
          type: string
          description: >-
            Country code of the legal entity (ISO 3166-1 alpha-2). Must not be
            'LT' — Lithuanian beneficiaries are already known to VMI
          example: LV
          minLength: 1
        address:
          type: string
          description: Address of the beneficiary in free form
          example: Vilnius, Lvovo g. 25
          maxLength: 240
          minLength: 0
        beneficiary:
          $ref: '#/components/schemas/Person'
        refId:
          type: string
          description: >-
            Unique reference ID of the beneficiary. Store it for future updates
            or deletions
          example: 305697289_20250303_E5D11991C7B74CB0
      required:
        - beneficiary
        - codeInForeignCountry
        - country
        - dateFrom
        - name
        - refId
    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
    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

````