> ## 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 errors > Retrieve beneficiary errors returned from the tax authority. ## OpenAPI ````yaml get /reports/sask/v1/errors/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/errors/beneficiaries: get: tags: - MMR-SASK Push API summary: Retrieve beneficiaries errors returned from tax authority description: >- Returns a page of beneficiaries that currently have unresolved validation errors from the Lithuanian tax authority (VMI), together with the error codes and messages. An entry disappears from this list once the record is successfully reported to the tax authority. operationId: getBeneficiaryErrors parameters: - name: page in: query required: false schema: type: integer format: int32 default: 0 - name: pageSize in: query required: false schema: type: integer format: int32 default: 50 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/BeneficiaryResultPaged' example: content: - status: SUCCESS data: codeInForeignCountry: '305697289' name: UAB Inventi country: LV beneficiary: type: F name: Jonas surname: Jonaitis refId: 305697289_20250303_F1A2B3C4D5E6 errors: - code: '39' fields: - beneficiary.name - beneficiary.surname message: >- The name does not match the identification code. Please correct the name or the identification code. page: size: 50 number: 0 totalElements: 1 totalPages: 1 components: schemas: BeneficiaryResultPaged: type: object properties: page: $ref: '#/components/schemas/PageMetadata' content: type: array items: $ref: '#/components/schemas/BeneficiaryResult' PageMetadata: type: object properties: size: type: integer format: int64 number: type: integer format: int64 totalElements: type: integer format: int64 totalPages: type: integer format: int64 BeneficiaryResult: type: object properties: status: $ref: '#/components/schemas/Status' data: $ref: '#/components/schemas/SaskBeneficiaryResponse' errors: type: array items: $ref: '#/components/schemas/FieldError' Status: type: string enum: - SUCCESS - FAILED 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) 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 FieldError: type: object properties: code: type: string description: >- Validation error code returned by the Lithuanian tax authority (VMI). Only present for records that failed VMI data validation example: 51 fields: type: array description: Fields that caused the error example: - iban items: type: string message: type: string description: Error message example: must not be empty 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}$ 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 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 ````