> ## Documentation Index > Fetch the complete documentation index at: https://docs.nuvera.global/llms.txt > Use this file to discover all available pages before exploring further. # Update customer > Update customer fields. Only allowed when status is DRAFT or CORRECTION_REQUESTED. ## OpenAPI ````yaml /api-reference/openapi.json patch /api/v1/customers/{id} openapi: 3.1.0 info: title: Nuvera API description: Nuvera Payment Platform REST API version: '1.0' contact: {} servers: - url: http://localhost:45000 security: [] tags: [] paths: /api/v1/customers/{id}: patch: tags: - Customers summary: Update customer description: >- Update customer fields. Only allowed when status is DRAFT or CORRECTION_REQUESTED. operationId: CustomerController_update parameters: - name: id required: true in: path schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateCustomerDto' responses: default: description: '' content: application/json: schema: $ref: '#/components/schemas/CustomerOutputDto_Output' security: - x-api-key: [] signed-request: [] components: schemas: UpdateCustomerDto: type: object properties: id: type: string companyName: type: string minLength: 1 maxLength: 200 registrationNumber: type: string minLength: 1 maxLength: 100 countryOfIncorporationId: type: string minLength: 1 tradingNames: type: string businessIndustryId: type: string minLength: 1 website: anyOf: - type: string format: uri - type: string const: '' operationalChannels: type: string businessEmail: anyOf: - type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ - type: string const: '' primaryContactFirstName: type: string primaryContactLastName: type: string primaryContactPhone: type: string primaryContactEmail: anyOf: - type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ - type: string const: '' primaryContactIsAssociate: type: boolean businessType: type: string enum: - COOPERATIVE - S_CORPORATION - B_CORPORATION - C_CORPORATION - CLOSE_CORPORATION - NONPROFIT_CORPORATION - GENERAL_PARTNERSHIP - LIMITED_PARTNERSHIP - LIMITED_LIABILITY_COMPANY - SOLE_PROPRIETORSHIP - TRUST - OTHER formationDate: type: string phone: type: string addressLine1: type: string addressLine2: type: string city: type: string stateProvinceRegion: type: string postalCode: type: string addressCountryId: type: string estimatedAnnualRevenueUsd: type: string enum: - R_0_99999 - R_100000_999999 - R_1000000_9999999 - R_10000000_49999999 - R_50000000_249999999 - R_250000000_PLUS expectedMonthlyPaymentsUsd: type: string primaryBusinessPurpose: type: string enum: - CHARITABLE_DONATIONS - ECOMMERCE_RETAIL_PAYMENTS - INVESTMENT_PURPOSES - OTHER - PAYMENTS_TO_FRIENDS_OR_FAMILY_ABROAD - PAYROLL - PERSONAL_OR_LIVING_EXPENSES - PROTECT_WEALTH - PURCHASE_GOODS_AND_SERVICES - RECEIVE_PAYMENTS_FOR_GOODS_AND_SERVICES - TAX_OPTIMIZATION - THIRD_PARTY_MONEY_TRANSMISSION - TREASURY_MANAGEMENT sourceOfFunds: type: string enum: - BUSINESS_LOANS - GRANTS - INTER_COMPANY_FUNDS - INVESTMENT_PROCEEDS - LEGAL_SETTLEMENT - OWNERS_CAPITAL - PENSION_RETIREMENT - SALE_OF_ASSETS - SALE_OF_ASSETS_REAL_ESTATE - SALES_OF_GOODS_AND_SERVICES - SAVINGS - TAX_REFUND - THIRD_PARTY_FUNDS - TREASURY_RESERVES taxIdType: type: string enum: - EIN - SSN - VAT - TIN - UTR taxIdentificationNumber: type: string operatesInProhibitedCountries: type: boolean highRiskActivities: type: array items: type: string enum: - NONE_OF_THE_ABOVE - ADULT_ENTERTAINMENT - GAMBLING - HOLD_CLIENT_FUNDS - INVESTMENT_SERVICES - LENDING_BANKING - MARIJUANA - PRECIOUS_METALS_STONES - WEAPONS_FIREARMS transmitsCustomerFunds: type: boolean customerFundsDescription: type: string conductsMoneyServices: type: boolean primaryPurposeOther: type: string ownershipIndirectOrOffshoreStructures: type: string enum: - 'YES' - 'NO' - PARTIALLY ownershipTrustsFundsOrHoldingCompanies: type: boolean ownershipBranchesOrSubsidiaries: type: boolean ownershipBranchesOrSubsidiariesDetails: type: string businessModelDescription: type: string customerType: type: string enum: - B2C - B2B - BOTH invoiceIssuance: type: string enum: - YES_ALWAYS - SOMETIMES - 'NO' productServiceCatalogueWithPrices: type: boolean mainCustomers: type: string mainSuppliers: type: string completeFlowOfFunds: type: string significantCashVolumes: type: boolean holdsClientBalances: type: boolean receivesUnrelatedThirdPartyPayments: type: boolean primaryOperatingCurrency: type: string fxConversion: type: boolean fxConversionDescription: type: string endCustomersIdentified: type: string enum: - ALWAYS - MOST_CASES - NOT_NECESSARILY countriesWhereOperatesOrCustomers: type: string averageTransactionAmountUsd: type: string geographicDistribution: type: string registeredPaidInCapitalUsd: type: string lastFinancialStatementsClosingDate: type: string lastFinancialStatementsAudited: type: boolean virtualAccountPurpose: type: array items: type: string enum: - COLLECT_CUSTOMER_PAYMENTS - PAY_SUPPLIERS - TREASURY - FX_SETTLEMENT - MARKETPLACE_SETTLEMENT - OTHER virtualAccountPurposeOther: type: string virtualAccountBalanceUsage: type: string enum: - HOLD_BALANCES - PASS_THROUGH_ONLY - BOTH virtualAccountUseContext: type: string fatfHighRiskExposure: type: string enum: - 'YES' - 'NO' - UNKNOWN sanctionsExposure: type: string enum: - 'YES' - 'NO' - PERIODIC_SCREENING regulatedInAnyJurisdiction: type: boolean regulatedJurisdictionDetails: type: string amlCftObligatedEntity: type: string enum: - 'YES' - 'NO' - NOT_APPLICABLE formalAmlCftProgramme: type: string enum: - DOCUMENTED - UNDER_DEVELOPMENT - 'NO' priorSanctionsInvestigations: type: boolean priorSanctionsInvestigationsDetails: type: string bankingPspRelationships: type: string pepDeclarationStatus: type: string enum: - NO_PEP - HAS_PEP pepDeclarationDetails: type: string pepAttestationSignerName: type: string pepAttestationDocumentNumber: type: string pepAttestationSignerTitle: type: string pepAttestationCompanyName: type: string pepDeclarationAttested: type: boolean currentStep: type: integer minimum: 1 maximum: 8 documentIds: type: array items: type: string persons: type: array items: type: object properties: firstName: type: string minLength: 1 description: First name lastName: type: string minLength: 1 description: Last name roles: minItems: 1 type: array items: type: string enum: - SHAREHOLDER - UBO - DIRECTOR - OWNER_OR_OPERATOR - PARTNER - AGENT_OR_AUTHORISED_PERSON description: Roles held by this person ownershipPercent: description: >- Ownership percentage (optional for directors with no ownership) type: number minimum: 0 maximum: 100 nationality: type: string minLength: 1 description: Nationality dateOfBirth: type: string format: date pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ description: Date of birth (YYYY-MM-DD) documentIds: type: array items: type: string description: >- IDs of uploaded KYC documents (ID front, ID back, proof of address) email: description: Email address type: string format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ phone: description: Phone number type: string addressLine1: description: Address line 1 type: string addressLine2: description: Address line 2 type: string city: description: City type: string stateProvinceRegion: description: State/Province/Region type: string postalCode: description: Postal code type: string addressCountryId: description: Address country ID type: string taxIdentificationNumber: description: Tax identification number type: string taxResidenceCountryId: description: Country of tax residence type: string businessTitle: description: Business title type: string relationshipEstablishedAt: description: Date relationship was established type: string idNumber: description: ID number type: string id: type: string required: - firstName - lastName - roles - nationality - dateOfBirth - documentIds legalEntityShareholders: type: array items: anyOf: - type: object properties: id: type: string companyLegalName: type: string registrationNumber: type: string countryOfIncorporationId: type: string entityType: type: string enum: - HOLDING - FUND - TRUST - OPERATING_COMPANY - OTHER roles: minItems: 1 type: array items: type: string enum: - SHAREHOLDER - PARTNER ownershipPercent: type: number minimum: 0 maximum: 100 documentIds: type: array items: type: string required: - id - type: object properties: companyLegalName: type: string minLength: 1 description: Company legal name registrationNumber: type: string minLength: 1 description: Registration number countryOfIncorporationId: type: string minLength: 1 description: Country of incorporation entityType: type: string enum: - HOLDING - FUND - TRUST - OPERATING_COMPANY - OTHER description: Legal entity type roles: minItems: 1 type: array items: type: string enum: - SHAREHOLDER - PARTNER description: Legal entity roles ownershipPercent: type: number minimum: 0 maximum: 100 documentIds: type: array items: type: string description: IDs of uploaded legal entity shareholder documents required: - companyLegalName - registrationNumber - countryOfIncorporationId - entityType - roles - ownershipPercent - documentIds required: - id CustomerOutputDto_Output: type: object properties: id: type: string orgId: type: string companyName: type: string registrationNumber: type: string countryOfIncorporationId: anyOf: - type: string - type: 'null' countryOfIncorporation: anyOf: - type: object properties: alpha2: type: string name: type: string required: - alpha2 - name additionalProperties: false - type: 'null' tradingNames: anyOf: - type: string - type: 'null' businessIndustryId: anyOf: - type: string - type: 'null' businessIndustry: anyOf: - type: object properties: code: type: string name: type: string required: - code - name additionalProperties: false - type: 'null' website: anyOf: - type: string - type: 'null' operationalChannels: anyOf: - type: string - type: 'null' businessEmail: anyOf: - type: string - type: 'null' primaryContactFirstName: anyOf: - type: string - type: 'null' primaryContactLastName: anyOf: - type: string - type: 'null' primaryContactPhone: anyOf: - type: string - type: 'null' primaryContactEmail: anyOf: - type: string - type: 'null' primaryContactIsAssociate: anyOf: - type: boolean - type: 'null' businessType: anyOf: - type: string - type: 'null' formationDate: anyOf: - type: string - type: 'null' phone: anyOf: - type: string - type: 'null' addressLine1: anyOf: - type: string - type: 'null' addressLine2: anyOf: - type: string - type: 'null' city: anyOf: - type: string - type: 'null' stateProvinceRegion: anyOf: - type: string - type: 'null' postalCode: anyOf: - type: string - type: 'null' addressCountryId: anyOf: - type: string - type: 'null' addressCountry: anyOf: - type: object properties: alpha2: type: string name: type: string required: - alpha2 - name additionalProperties: false - type: 'null' estimatedAnnualRevenueUsd: anyOf: - type: string - type: 'null' expectedMonthlyPaymentsUsd: type: string primaryBusinessPurpose: anyOf: - type: string - type: 'null' sourceOfFunds: anyOf: - type: string - type: 'null' taxIdType: anyOf: - type: string - type: 'null' taxIdentificationNumber: anyOf: - type: string - type: 'null' operatesInProhibitedCountries: anyOf: - type: boolean - type: 'null' highRiskActivities: anyOf: - type: array items: type: string - type: 'null' transmitsCustomerFunds: anyOf: - type: boolean - type: 'null' customerFundsDescription: anyOf: - type: string - type: 'null' conductsMoneyServices: anyOf: - type: boolean - type: 'null' primaryPurposeOther: anyOf: - type: string - type: 'null' ownershipIndirectOrOffshoreStructures: anyOf: - type: string - type: 'null' ownershipTrustsFundsOrHoldingCompanies: anyOf: - type: boolean - type: 'null' ownershipBranchesOrSubsidiaries: anyOf: - type: boolean - type: 'null' ownershipBranchesOrSubsidiariesDetails: anyOf: - type: string - type: 'null' businessModelDescription: anyOf: - type: string - type: 'null' customerType: anyOf: - type: string - type: 'null' invoiceIssuance: anyOf: - type: string - type: 'null' productServiceCatalogueWithPrices: anyOf: - type: boolean - type: 'null' mainCustomers: anyOf: - type: string - type: 'null' mainSuppliers: anyOf: - type: string - type: 'null' completeFlowOfFunds: anyOf: - type: string - type: 'null' significantCashVolumes: anyOf: - type: boolean - type: 'null' holdsClientBalances: anyOf: - type: boolean - type: 'null' receivesUnrelatedThirdPartyPayments: anyOf: - type: boolean - type: 'null' primaryOperatingCurrency: anyOf: - type: string - type: 'null' fxConversion: anyOf: - type: boolean - type: 'null' fxConversionDescription: anyOf: - type: string - type: 'null' endCustomersIdentified: anyOf: - type: string - type: 'null' countriesWhereOperatesOrCustomers: anyOf: - type: string - type: 'null' averageTransactionAmountUsd: anyOf: - type: string - type: 'null' geographicDistribution: anyOf: - type: string - type: 'null' registeredPaidInCapitalUsd: anyOf: - type: string - type: 'null' lastFinancialStatementsClosingDate: anyOf: - type: string - type: 'null' lastFinancialStatementsAudited: anyOf: - type: boolean - type: 'null' virtualAccountPurpose: anyOf: - type: array items: type: string - type: 'null' virtualAccountPurposeOther: anyOf: - type: string - type: 'null' virtualAccountBalanceUsage: anyOf: - type: string - type: 'null' virtualAccountUseContext: anyOf: - type: string - type: 'null' fatfHighRiskExposure: anyOf: - type: string - type: 'null' sanctionsExposure: anyOf: - type: string - type: 'null' regulatedInAnyJurisdiction: anyOf: - type: boolean - type: 'null' regulatedJurisdictionDetails: anyOf: - type: string - type: 'null' amlCftObligatedEntity: anyOf: - type: string - type: 'null' formalAmlCftProgramme: anyOf: - type: string - type: 'null' priorSanctionsInvestigations: anyOf: - type: boolean - type: 'null' priorSanctionsInvestigationsDetails: anyOf: - type: string - type: 'null' bankingPspRelationships: anyOf: - type: string - type: 'null' pepDeclarationStatus: anyOf: - type: string - type: 'null' pepDeclarationDetails: anyOf: - type: string - type: 'null' pepAttestationSignerName: anyOf: - type: string - type: 'null' pepAttestationDocumentNumber: anyOf: - type: string - type: 'null' pepAttestationSignerTitle: anyOf: - type: string - type: 'null' pepAttestationCompanyName: anyOf: - type: string - type: 'null' pepDeclarationAttested: anyOf: - type: boolean - type: 'null' status: type: string currentStep: type: number createdAt: type: string updatedAt: type: string beneficiaryCount: type: number paymentCount: type: number persons: type: array items: type: object properties: id: type: string customerId: type: string firstName: type: string lastName: type: string roles: type: array items: type: string ownershipPercent: anyOf: - type: number - type: 'null' nationalityId: anyOf: - type: string - type: 'null' dateOfBirth: type: string email: anyOf: - type: string - type: 'null' phone: anyOf: - type: string - type: 'null' addressLine1: anyOf: - type: string - type: 'null' addressLine2: anyOf: - type: string - type: 'null' city: anyOf: - type: string - type: 'null' stateProvinceRegion: anyOf: - type: string - type: 'null' postalCode: anyOf: - type: string - type: 'null' addressCountryId: anyOf: - type: string - type: 'null' taxIdentificationNumber: anyOf: - type: string - type: 'null' taxResidenceCountryId: anyOf: - type: string - type: 'null' businessTitle: anyOf: - type: string - type: 'null' relationshipEstablishedAt: anyOf: - type: string - type: 'null' idNumber: anyOf: - type: string - type: 'null' createdAt: type: string updatedAt: type: string required: - id - customerId - firstName - lastName - roles - ownershipPercent - nationalityId - dateOfBirth - email - phone - addressLine1 - addressLine2 - city - stateProvinceRegion - postalCode - addressCountryId - taxIdentificationNumber - taxResidenceCountryId - businessTitle - relationshipEstablishedAt - idNumber - createdAt - updatedAt additionalProperties: false legalEntityShareholders: type: array items: type: object properties: id: type: string customerId: type: string companyLegalName: type: string registrationNumber: type: string countryOfIncorporationId: type: string countryOfIncorporation: anyOf: - type: object properties: alpha2: type: string name: type: string required: - alpha2 - name additionalProperties: false - type: 'null' entityType: type: string roles: type: array items: type: string ownershipPercent: type: number createdAt: type: string updatedAt: type: string required: - id - customerId - companyLegalName - registrationNumber - countryOfIncorporationId - entityType - roles - ownershipPercent - createdAt - updatedAt additionalProperties: false required: - id - orgId - companyName - registrationNumber - countryOfIncorporationId - tradingNames - businessIndustryId - website - operationalChannels - businessEmail - primaryContactFirstName - primaryContactLastName - primaryContactPhone - primaryContactEmail - primaryContactIsAssociate - businessType - formationDate - phone - addressLine1 - addressLine2 - city - stateProvinceRegion - postalCode - addressCountryId - estimatedAnnualRevenueUsd - expectedMonthlyPaymentsUsd - primaryBusinessPurpose - sourceOfFunds - taxIdType - taxIdentificationNumber - operatesInProhibitedCountries - highRiskActivities - transmitsCustomerFunds - customerFundsDescription - conductsMoneyServices - primaryPurposeOther - ownershipIndirectOrOffshoreStructures - ownershipTrustsFundsOrHoldingCompanies - ownershipBranchesOrSubsidiaries - ownershipBranchesOrSubsidiariesDetails - businessModelDescription - customerType - invoiceIssuance - productServiceCatalogueWithPrices - mainCustomers - mainSuppliers - completeFlowOfFunds - significantCashVolumes - holdsClientBalances - receivesUnrelatedThirdPartyPayments - primaryOperatingCurrency - fxConversion - fxConversionDescription - endCustomersIdentified - countriesWhereOperatesOrCustomers - averageTransactionAmountUsd - geographicDistribution - registeredPaidInCapitalUsd - lastFinancialStatementsClosingDate - lastFinancialStatementsAudited - virtualAccountPurpose - virtualAccountPurposeOther - virtualAccountBalanceUsage - virtualAccountUseContext - fatfHighRiskExposure - sanctionsExposure - regulatedInAnyJurisdiction - regulatedJurisdictionDetails - amlCftObligatedEntity - formalAmlCftProgramme - priorSanctionsInvestigations - priorSanctionsInvestigationsDetails - bankingPspRelationships - pepDeclarationStatus - pepDeclarationDetails - pepAttestationSignerName - pepAttestationDocumentNumber - pepAttestationSignerTitle - pepAttestationCompanyName - pepDeclarationAttested - status - currentStep - createdAt - updatedAt additionalProperties: false securitySchemes: x-api-key: type: apiKey in: header name: x-api-key description: Nuvera API application secret key signed-request: scheme: bearer bearerFormat: JWT type: http description: RS256 per-request signed JWT ````