> ## 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. # Update beneficiaries > Update existing beneficiaries by reference ID. ## OpenAPI ````yaml put /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: put: tags: - MMR-SASK Push API summary: Update beneficiaries description: >- Update existing beneficiaries by refId. The response also returns a refId which must be saved on the client side to be able to update the records in the future. It may be the same or a different one. operationId: updateBeneficiaries requestBody: content: application/json: schema: type: array items: $ref: '#/components/schemas/SaskBeneficiaryUpdateRequest' example: - refId: 305697289_20250303_F1A2B3C4D5E6 codeInForeignCountry: '305697289' name: UAB Inventi dateFrom: '2024-12-18' dateTo: '2025-12-31' country: LV address: Vilnius, Lvovo g. 25 beneficiary: type: F name: Jonas surname: Jonaitis birthDate: '1990-05-15' addressCountry: LV address: Riga, Alberta st. 1 codeCountry: LV codeInForeignCountry: '39001011234' documentType: NON_LT_PASSPORT documentNumber: AB123456 nationalities: - LV required: true responses: '200': description: All updated content: application/json: schema: type: array items: $ref: '#/components/schemas/BeneficiaryResult' example: - status: SUCCESS data: codeInForeignCountry: '305697289' name: UAB Inventi dateFrom: '2024-12-18' dateTo: '2025-12-31' country: LV address: Vilnius, Lvovo g. 25 beneficiary: type: F name: Jonas surname: Jonaitis birthDate: '1990-05-15' addressCountry: LV address: Riga, Alberta st. 1 codeCountry: LV codeInForeignCountry: '39001011234' documentType: NON_LT_PASSPORT documentNumber: AB123456 nationalities: - LV refId: 305697289_20250303_F1A2B3C4D5E6 '207': description: Partial success content: application/json: schema: type: array items: $ref: '#/components/schemas/BeneficiaryResult' example: - status: SUCCESS data: codeInForeignCountry: '305697289' name: UAB Inventi dateFrom: '2024-12-18' dateTo: '2025-12-31' country: LV address: Vilnius, Lvovo g. 25 beneficiary: type: F name: Jonas surname: Jonaitis birthDate: '1990-05-15' addressCountry: LV address: Riga, Alberta st. 1 codeCountry: LV codeInForeignCountry: '39001011234' documentType: NON_LT_PASSPORT documentNumber: AB123456 nationalities: - LV refId: 305697289_20250303_F1A2B3C4D5E6 - status: FAILED data: codeInForeignCountry: '305697289' name: UAB Inventi dateFrom: '2024-12-18' address: Vilnius, Lvovo g. 25 beneficiary: type: F name: Jonas surname: Jonaitis birthDate: '1990-05-15' addressCountry: LV address: Riga, Alberta st. 1 codeCountry: LV codeInForeignCountry: '39001011234' documentType: NON_LT_PASSPORT documentNumber: AB123456 nationalities: - LV refId: 305697289_20250303_G7H8I9J0K1L2 errors: - fields: - country message: must not be empty '400': description: All failed content: application/json: schema: type: array items: $ref: '#/components/schemas/BeneficiaryResult' example: - status: FAILED data: codeInForeignCountry: '305697289' name: UAB Inventi dateFrom: '2024-12-18' address: Vilnius, Lvovo g. 25 beneficiary: type: F name: Jonas surname: Jonaitis birthDate: '1990-05-15' addressCountry: LV address: Riga, Alberta st. 1 codeCountry: LV codeInForeignCountry: '39001011234' documentType: NON_LT_PASSPORT documentNumber: AB123456 nationalities: - LV refId: 305697289_20250303_G7H8I9J0K1L2 errors: - fields: - country message: must not be empty components: schemas: SaskBeneficiaryUpdateRequest: 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: Reference ID of the beneficiary to update example: 3c247e0c-944f-43d0-be20-a0c502d13f26 required: - beneficiary - codeInForeignCountry - country - dateFrom - name - refId BeneficiaryResult: type: object properties: status: $ref: '#/components/schemas/Status' data: $ref: '#/components/schemas/SaskBeneficiaryResponse' errors: type: array items: $ref: '#/components/schemas/FieldError' 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 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 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 ````