> ## 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. # Create representatives > Add representatives to an existing account. ## OpenAPI ````yaml post /reports/sask/v1/accounts/{accountRefId}/representatives 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/{accountRefId}/representatives: post: tags: - MMR-SASK Push API summary: Create representatives description: >- Add representatives to an existing account identified by accountRefId. The response returns a refId for each successfully created representative. It must be saved on the client side to be able to update or delete the record in the future. operationId: createRepresentatives parameters: - name: Idempotency-Key in: header description: >- Client-provided idempotency key. UUID v4 suggested, max 255 characters. If provided, duplicate requests with the same key will return the cached response. schema: type: string maxLength: 255 pattern: \S - name: accountRefId in: path required: true schema: type: string requestBody: content: application/json: schema: type: array items: $ref: '#/components/schemas/SaskRepresentativeCreateRequest' example: - dateFrom: '2024-12-18' dateTo: '2025-12-31' representative: 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: '201': description: All created content: application/json: schema: type: array items: $ref: '#/components/schemas/RepresentativeResult' example: - status: SUCCESS data: dateFrom: '2024-12-18' dateTo: '2025-12-31' representative: 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: a8306155-8731-4aea-9b36-d30e958fbe33 '207': description: Partial success content: application/json: schema: type: array items: $ref: '#/components/schemas/RepresentativeResult' example: - status: SUCCESS data: dateFrom: '2024-12-18' dateTo: '2025-12-31' representative: 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: a8306155-8731-4aea-9b36-d30e958fbe33 - status: FAILED data: dateTo: '2025-12-31' representative: 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 errors: - fields: - dateFrom message: must not be null '400': description: All failed content: application/json: schema: type: array items: $ref: '#/components/schemas/RepresentativeResult' example: - status: FAILED data: dateTo: '2025-12-31' representative: 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 errors: - fields: - dateFrom message: must not be null components: schemas: SaskRepresentativeCreateRequest: 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' required: - dateFrom - representative RepresentativeResult: type: object properties: status: $ref: '#/components/schemas/Status' data: $ref: '#/components/schemas/SaskRepresentativeResponse' 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 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 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 ````