Support

Update a KYB record

PATCH /kyb/{kybId}

Parameters

kybId string Required path

The unique ID of the current KYB record for an entity. Same as currentKybId on the entity object.

x-tenant-id string Required header

Tenant identifier. Required on all tenant-scoped routes.

More parameters Expand all

countryName string

No description.

countryCode string

No description.

registrationNumber string

No description.

jurisdictionCode string

No description.

companyName string

No description.

verificationStatus enum

No description.

Possible values: pendingapprovedresubmissionrejected

submissionCompleted boolean

No description.

kybFormData object

No description.

compliances array of objects

No description.

clientInformation object

No description.

ownershipAndControl object

No description.

managementDetails object

No description.

sourceOfFundsAndWealth object

No description.

pepDetails object

No description.

servicesRequested object

No description.

documentsProvided object

No description.

clientDeclaration object

No description.

isSubmitted boolean

No description.

PATCH /kyb/{kybId}

curl -X PATCH "https://heimdall.qa.zoniqx.com/kyb/<kybId>" \
  -H "Authorization: Bearer <accessToken>" \
  -H "x-tenant-id: <your-tenant-id>" \
  -H "Content-Type: application/json" \
  -d '{
      "countryName": "string",
      "countryCode": "string",
      "registrationNumber": "string",
      "jurisdictionCode": "string",
      "companyName": "string",
      "verificationStatus": "pending",
      "submissionCompleted": true,
      "kybFormData": {
        "identity": "kyc",
        "compliances": [
          {
            "condition": {
              "condition": "string",
              "checked": true
            },
            "description": "string"
          }
        ],
        "clientInformation": {
          "entityName": "string",
          "tradeName": "string",
          "legalStatus": "sole_proprietorship",
          "legalStatusOther": "string",
          "placeOfIncorporation": "string",
          "dateOfIncorporation": "string",
          "countryOfOperation": "string",
          "licenseNumber": "string",
          "licenseIssueDate": "string",
          "licenseExpiryDate": "string",
          "licenseIssuingAuthority": "string",
          "registrationNumber": "string",
          "vatRegistrationNumber": "string",
          "mainLicensedActivity": "string",
          "registeredAddress": "string",
          "contactPerson": {
            "name": "string",
            "phoneNumber": "string",
            "mobileNumber": "string",
            "designation": "string",
            "email": "user@example.com"
          },
          "communicationType": "face_to_face"
        },
        "ownershipAndControl": {
          "owners": [
            {
              "fullLegalName": "string",
              "nationality": "string",
              "countryOfRegistration": "string",
              "countryOfResidence": "string",
              "shareholdingPercentage": 0
            }
          ]
        },
        "managementDetails": {
          "directorsAndManagement": [
            {
              "fullName": "string",
              "designation": "string",
              "nationality": "string",
              "countryOfResidence": "string"
            }
          ]
        },
        "sourceOfFundsAndWealth": {
          "sourceOfFunds": {
            "types": [
              "business_income"
            ],
            "otherDescription": "string"
          },
          "sourceOfWealth": {
            "types": [
              "business_income"
            ],
            "otherDescription": "string"
          },
          "countryOfOriginOfFunds": "string"
        },
        "pepDetails": {
          "isPep": true,
          "pepInfo": {
            "name": "string",
            "positionOrRole": "string",
            "relationshipToEntity": "string",
            "countryOfPublicFunction": "string"
          },
          "hasRelatedPep": true,
          "relatedPepInfo": {
            "name": "string",
            "relationshipToEntity": "string",
            "positionOrRole": "string",
            "countryOfPublicFunction": "string"
          }
        },
        "servicesRequested": {
          "services": [
            "fund_management"
          ],
          "otherServiceDescription": "string",
          "relationshipPurpose": "string"
        },
        "documentsProvided": {
          "commercialLicense": "string",
          "certificateOfIncorporation": "string",
          "incumbencyOrShareRegister": "string",
          "moaAoa": "string",
          "trustDeed": "string",
          "foundationCharter": "string",
          "passportsOfUBOs": [
            "string"
          ],
          "proofOfAddress": "string",
          "vatCertificate": "string",
          "structureChart": "string",
          "poaIfApplicable": "string",
          "commercialLicenseAndCertificateOfIncorporation": [
            "string"
          ],
          "additionalDocuments": [
            "string"
          ]
        },
        "clientDeclaration": {
          "fullName": "string",
          "designation": "string",
          "companyName": "string",
          "signedAt": "string",
          "signatureAccepted": true
        }
      },
      "compliances": [
        {
          "condition": {
            "condition": "string",
            "checked": true
          },
          "description": "string"
        }
      ],
      "clientInformation": {
        "entityName": "string",
        "tradeName": "string",
        "legalStatus": "sole_proprietorship",
        "legalStatusOther": "string",
        "placeOfIncorporation": "string",
        "dateOfIncorporation": "string",
        "countryOfOperation": "string",
        "licenseNumber": "string",
        "licenseIssueDate": "string",
        "licenseExpiryDate": "string",
        "licenseIssuingAuthority": "string",
        "registrationNumber": "string",
        "vatRegistrationNumber": "string",
        "mainLicensedActivity": "string",
        "registeredAddress": "string",
        "contactPerson": {
          "name": "string",
          "phoneNumber": "string",
          "mobileNumber": "string",
          "designation": "string",
          "email": "user@example.com"
        },
        "communicationType": "face_to_face"
      },
      "ownershipAndControl": {
        "owners": [
          {
            "fullLegalName": "string",
            "nationality": "string",
            "countryOfRegistration": "string",
            "countryOfResidence": "string",
            "shareholdingPercentage": 0
          }
        ]
      },
      "managementDetails": {
        "directorsAndManagement": [
          {
            "fullName": "string",
            "designation": "string",
            "nationality": "string",
            "countryOfResidence": "string"
          }
        ]
      },
      "sourceOfFundsAndWealth": {
        "sourceOfFunds": {
          "types": [
            "business_income"
          ],
          "otherDescription": "string"
        },
        "sourceOfWealth": {
          "types": [
            "business_income"
          ],
          "otherDescription": "string"
        },
        "countryOfOriginOfFunds": "string"
      },
      "pepDetails": {
        "isPep": true,
        "pepInfo": {
          "name": "string",
          "positionOrRole": "string",
          "relationshipToEntity": "string",
          "countryOfPublicFunction": "string"
        },
        "hasRelatedPep": true,
        "relatedPepInfo": {
          "name": "string",
          "relationshipToEntity": "string",
          "positionOrRole": "string",
          "countryOfPublicFunction": "string"
        }
      },
      "servicesRequested": {
        "services": [
          "fund_management"
        ],
        "otherServiceDescription": "string",
        "relationshipPurpose": "string"
      },
      "documentsProvided": {
        "commercialLicense": "string",
        "certificateOfIncorporation": "string",
        "incumbencyOrShareRegister": "string",
        "moaAoa": "string",
        "trustDeed": "string",
        "foundationCharter": "string",
        "passportsOfUBOs": [
          "string"
        ],
        "proofOfAddress": "string",
        "vatCertificate": "string",
        "structureChart": "string",
        "poaIfApplicable": "string",
        "commercialLicenseAndCertificateOfIncorporation": [
          "string"
        ],
        "additionalDocuments": [
          "string"
        ]
      },
      "clientDeclaration": {
        "fullName": "string",
        "designation": "string",
        "companyName": "string",
        "signedAt": "string",
        "signatureAccepted": true
      },
      "isSubmitted": true
    }'

const response = await fetch("https://heimdall.qa.zoniqx.com/kyb/<kybId>", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer <accessToken>",
    "x-tenant-id": "<your-tenant-id>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "countryName": "string",
    "countryCode": "string",
    "registrationNumber": "string",
    "jurisdictionCode": "string",
    "companyName": "string",
    "verificationStatus": "pending",
    "submissionCompleted": true,
    "kybFormData": {
      "identity": "kyc",
      "compliances": [
        {
          "condition": {
            "condition": "string",
            "checked": true
          },
          "description": "string"
        }
      ],
      "clientInformation": {
        "entityName": "string",
        "tradeName": "string",
        "legalStatus": "sole_proprietorship",
        "legalStatusOther": "string",
        "placeOfIncorporation": "string",
        "dateOfIncorporation": "string",
        "countryOfOperation": "string",
        "licenseNumber": "string",
        "licenseIssueDate": "string",
        "licenseExpiryDate": "string",
        "licenseIssuingAuthority": "string",
        "registrationNumber": "string",
        "vatRegistrationNumber": "string",
        "mainLicensedActivity": "string",
        "registeredAddress": "string",
        "contactPerson": {
          "name": "string",
          "phoneNumber": "string",
          "mobileNumber": "string",
          "designation": "string",
          "email": "user@example.com"
        },
        "communicationType": "face_to_face"
      },
      "ownershipAndControl": {
        "owners": [
          {
            "fullLegalName": "string",
            "nationality": "string",
            "countryOfRegistration": "string",
            "countryOfResidence": "string",
            "shareholdingPercentage": 0
          }
        ]
      },
      "managementDetails": {
        "directorsAndManagement": [
          {
            "fullName": "string",
            "designation": "string",
            "nationality": "string",
            "countryOfResidence": "string"
          }
        ]
      },
      "sourceOfFundsAndWealth": {
        "sourceOfFunds": {
          "types": [
            "business_income"
          ],
          "otherDescription": "string"
        },
        "sourceOfWealth": {
          "types": [
            "business_income"
          ],
          "otherDescription": "string"
        },
        "countryOfOriginOfFunds": "string"
      },
      "pepDetails": {
        "isPep": true,
        "pepInfo": {
          "name": "string",
          "positionOrRole": "string",
          "relationshipToEntity": "string",
          "countryOfPublicFunction": "string"
        },
        "hasRelatedPep": true,
        "relatedPepInfo": {
          "name": "string",
          "relationshipToEntity": "string",
          "positionOrRole": "string",
          "countryOfPublicFunction": "string"
        }
      },
      "servicesRequested": {
        "services": [
          "fund_management"
        ],
        "otherServiceDescription": "string",
        "relationshipPurpose": "string"
      },
      "documentsProvided": {
        "commercialLicense": "string",
        "certificateOfIncorporation": "string",
        "incumbencyOrShareRegister": "string",
        "moaAoa": "string",
        "trustDeed": "string",
        "foundationCharter": "string",
        "passportsOfUBOs": [
          "string"
        ],
        "proofOfAddress": "string",
        "vatCertificate": "string",
        "structureChart": "string",
        "poaIfApplicable": "string",
        "commercialLicenseAndCertificateOfIncorporation": [
          "string"
        ],
        "additionalDocuments": [
          "string"
        ]
      },
      "clientDeclaration": {
        "fullName": "string",
        "designation": "string",
        "companyName": "string",
        "signedAt": "string",
        "signatureAccepted": true
      }
    },
    "compliances": [
      {
        "condition": {
          "condition": "string",
          "checked": true
        },
        "description": "string"
      }
    ],
    "clientInformation": {
      "entityName": "string",
      "tradeName": "string",
      "legalStatus": "sole_proprietorship",
      "legalStatusOther": "string",
      "placeOfIncorporation": "string",
      "dateOfIncorporation": "string",
      "countryOfOperation": "string",
      "licenseNumber": "string",
      "licenseIssueDate": "string",
      "licenseExpiryDate": "string",
      "licenseIssuingAuthority": "string",
      "registrationNumber": "string",
      "vatRegistrationNumber": "string",
      "mainLicensedActivity": "string",
      "registeredAddress": "string",
      "contactPerson": {
        "name": "string",
        "phoneNumber": "string",
        "mobileNumber": "string",
        "designation": "string",
        "email": "user@example.com"
      },
      "communicationType": "face_to_face"
    },
    "ownershipAndControl": {
      "owners": [
        {
          "fullLegalName": "string",
          "nationality": "string",
          "countryOfRegistration": "string",
          "countryOfResidence": "string",
          "shareholdingPercentage": 0
        }
      ]
    },
    "managementDetails": {
      "directorsAndManagement": [
        {
          "fullName": "string",
          "designation": "string",
          "nationality": "string",
          "countryOfResidence": "string"
        }
      ]
    },
    "sourceOfFundsAndWealth": {
      "sourceOfFunds": {
        "types": [
          "business_income"
        ],
        "otherDescription": "string"
      },
      "sourceOfWealth": {
        "types": [
          "business_income"
        ],
        "otherDescription": "string"
      },
      "countryOfOriginOfFunds": "string"
    },
    "pepDetails": {
      "isPep": true,
      "pepInfo": {
        "name": "string",
        "positionOrRole": "string",
        "relationshipToEntity": "string",
        "countryOfPublicFunction": "string"
      },
      "hasRelatedPep": true,
      "relatedPepInfo": {
        "name": "string",
        "relationshipToEntity": "string",
        "positionOrRole": "string",
        "countryOfPublicFunction": "string"
      }
    },
    "servicesRequested": {
      "services": [
        "fund_management"
      ],
      "otherServiceDescription": "string",
      "relationshipPurpose": "string"
    },
    "documentsProvided": {
      "commercialLicense": "string",
      "certificateOfIncorporation": "string",
      "incumbencyOrShareRegister": "string",
      "moaAoa": "string",
      "trustDeed": "string",
      "foundationCharter": "string",
      "passportsOfUBOs": [
        "string"
      ],
      "proofOfAddress": "string",
      "vatCertificate": "string",
      "structureChart": "string",
      "poaIfApplicable": "string",
      "commercialLicenseAndCertificateOfIncorporation": [
        "string"
      ],
      "additionalDocuments": [
        "string"
      ]
    },
    "clientDeclaration": {
      "fullName": "string",
      "designation": "string",
      "companyName": "string",
      "signedAt": "string",
      "signatureAccepted": true
    },
    "isSubmitted": true
  }),
});

const data = await response.json();

type KybController_updateKybResponse = Record<string, unknown>;

const response = await fetch("https://heimdall.qa.zoniqx.com/kyb/<kybId>", {
  method: "PATCH",
  headers: {
    Authorization: "Bearer <accessToken>",
    "x-tenant-id": "<your-tenant-id>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "countryName": "string",
    "countryCode": "string",
    "registrationNumber": "string",
    "jurisdictionCode": "string",
    "companyName": "string",
    "verificationStatus": "pending",
    "submissionCompleted": true,
    "kybFormData": {
      "identity": "kyc",
      "compliances": [
        {
          "condition": {
            "condition": "string",
            "checked": true
          },
          "description": "string"
        }
      ],
      "clientInformation": {
        "entityName": "string",
        "tradeName": "string",
        "legalStatus": "sole_proprietorship",
        "legalStatusOther": "string",
        "placeOfIncorporation": "string",
        "dateOfIncorporation": "string",
        "countryOfOperation": "string",
        "licenseNumber": "string",
        "licenseIssueDate": "string",
        "licenseExpiryDate": "string",
        "licenseIssuingAuthority": "string",
        "registrationNumber": "string",
        "vatRegistrationNumber": "string",
        "mainLicensedActivity": "string",
        "registeredAddress": "string",
        "contactPerson": {
          "name": "string",
          "phoneNumber": "string",
          "mobileNumber": "string",
          "designation": "string",
          "email": "user@example.com"
        },
        "communicationType": "face_to_face"
      },
      "ownershipAndControl": {
        "owners": [
          {
            "fullLegalName": "string",
            "nationality": "string",
            "countryOfRegistration": "string",
            "countryOfResidence": "string",
            "shareholdingPercentage": 0
          }
        ]
      },
      "managementDetails": {
        "directorsAndManagement": [
          {
            "fullName": "string",
            "designation": "string",
            "nationality": "string",
            "countryOfResidence": "string"
          }
        ]
      },
      "sourceOfFundsAndWealth": {
        "sourceOfFunds": {
          "types": [
            "business_income"
          ],
          "otherDescription": "string"
        },
        "sourceOfWealth": {
          "types": [
            "business_income"
          ],
          "otherDescription": "string"
        },
        "countryOfOriginOfFunds": "string"
      },
      "pepDetails": {
        "isPep": true,
        "pepInfo": {
          "name": "string",
          "positionOrRole": "string",
          "relationshipToEntity": "string",
          "countryOfPublicFunction": "string"
        },
        "hasRelatedPep": true,
        "relatedPepInfo": {
          "name": "string",
          "relationshipToEntity": "string",
          "positionOrRole": "string",
          "countryOfPublicFunction": "string"
        }
      },
      "servicesRequested": {
        "services": [
          "fund_management"
        ],
        "otherServiceDescription": "string",
        "relationshipPurpose": "string"
      },
      "documentsProvided": {
        "commercialLicense": "string",
        "certificateOfIncorporation": "string",
        "incumbencyOrShareRegister": "string",
        "moaAoa": "string",
        "trustDeed": "string",
        "foundationCharter": "string",
        "passportsOfUBOs": [
          "string"
        ],
        "proofOfAddress": "string",
        "vatCertificate": "string",
        "structureChart": "string",
        "poaIfApplicable": "string",
        "commercialLicenseAndCertificateOfIncorporation": [
          "string"
        ],
        "additionalDocuments": [
          "string"
        ]
      },
      "clientDeclaration": {
        "fullName": "string",
        "designation": "string",
        "companyName": "string",
        "signedAt": "string",
        "signatureAccepted": true
      }
    },
    "compliances": [
      {
        "condition": {
          "condition": "string",
          "checked": true
        },
        "description": "string"
      }
    ],
    "clientInformation": {
      "entityName": "string",
      "tradeName": "string",
      "legalStatus": "sole_proprietorship",
      "legalStatusOther": "string",
      "placeOfIncorporation": "string",
      "dateOfIncorporation": "string",
      "countryOfOperation": "string",
      "licenseNumber": "string",
      "licenseIssueDate": "string",
      "licenseExpiryDate": "string",
      "licenseIssuingAuthority": "string",
      "registrationNumber": "string",
      "vatRegistrationNumber": "string",
      "mainLicensedActivity": "string",
      "registeredAddress": "string",
      "contactPerson": {
        "name": "string",
        "phoneNumber": "string",
        "mobileNumber": "string",
        "designation": "string",
        "email": "user@example.com"
      },
      "communicationType": "face_to_face"
    },
    "ownershipAndControl": {
      "owners": [
        {
          "fullLegalName": "string",
          "nationality": "string",
          "countryOfRegistration": "string",
          "countryOfResidence": "string",
          "shareholdingPercentage": 0
        }
      ]
    },
    "managementDetails": {
      "directorsAndManagement": [
        {
          "fullName": "string",
          "designation": "string",
          "nationality": "string",
          "countryOfResidence": "string"
        }
      ]
    },
    "sourceOfFundsAndWealth": {
      "sourceOfFunds": {
        "types": [
          "business_income"
        ],
        "otherDescription": "string"
      },
      "sourceOfWealth": {
        "types": [
          "business_income"
        ],
        "otherDescription": "string"
      },
      "countryOfOriginOfFunds": "string"
    },
    "pepDetails": {
      "isPep": true,
      "pepInfo": {
        "name": "string",
        "positionOrRole": "string",
        "relationshipToEntity": "string",
        "countryOfPublicFunction": "string"
      },
      "hasRelatedPep": true,
      "relatedPepInfo": {
        "name": "string",
        "relationshipToEntity": "string",
        "positionOrRole": "string",
        "countryOfPublicFunction": "string"
      }
    },
    "servicesRequested": {
      "services": [
        "fund_management"
      ],
      "otherServiceDescription": "string",
      "relationshipPurpose": "string"
    },
    "documentsProvided": {
      "commercialLicense": "string",
      "certificateOfIncorporation": "string",
      "incumbencyOrShareRegister": "string",
      "moaAoa": "string",
      "trustDeed": "string",
      "foundationCharter": "string",
      "passportsOfUBOs": [
        "string"
      ],
      "proofOfAddress": "string",
      "vatCertificate": "string",
      "structureChart": "string",
      "poaIfApplicable": "string",
      "commercialLicenseAndCertificateOfIncorporation": [
        "string"
      ],
      "additionalDocuments": [
        "string"
      ]
    },
    "clientDeclaration": {
      "fullName": "string",
      "designation": "string",
      "companyName": "string",
      "signedAt": "string",
      "signatureAccepted": true
    },
    "isSubmitted": true
  }),
});

const data: KybController_updateKybResponse = await response.json();

import requests

url = "https://heimdall.qa.zoniqx.com/kyb/<kybId>"

headers = {
    "Authorization": "Bearer <accessToken>",
    "x-tenant-id": "<your-tenant-id>",
}

payload = {
    "countryName": "string",
    "countryCode": "string",
    "registrationNumber": "string",
    "jurisdictionCode": "string",
    "companyName": "string",
    "verificationStatus": "pending",
    "submissionCompleted": True,
    "kybFormData": {
        "identity": "kyc",
        "compliances": [
            {
                "condition": {
                    "condition": "string",
                    "checked": True
                },
                "description": "string"
            }
        ],
        "clientInformation": {
            "entityName": "string",
            "tradeName": "string",
            "legalStatus": "sole_proprietorship",
            "legalStatusOther": "string",
            "placeOfIncorporation": "string",
            "dateOfIncorporation": "string",
            "countryOfOperation": "string",
            "licenseNumber": "string",
            "licenseIssueDate": "string",
            "licenseExpiryDate": "string",
            "licenseIssuingAuthority": "string",
            "registrationNumber": "string",
            "vatRegistrationNumber": "string",
            "mainLicensedActivity": "string",
            "registeredAddress": "string",
            "contactPerson": {
                "name": "string",
                "phoneNumber": "string",
                "mobileNumber": "string",
                "designation": "string",
                "email": "user@example.com"
            },
            "communicationType": "face_to_face"
        },
        "ownershipAndControl": {
            "owners": [
                {
                    "fullLegalName": "string",
                    "nationality": "string",
                    "countryOfRegistration": "string",
                    "countryOfResidence": "string",
                    "shareholdingPercentage": 0
                }
            ]
        },
        "managementDetails": {
            "directorsAndManagement": [
                {
                    "fullName": "string",
                    "designation": "string",
                    "nationality": "string",
                    "countryOfResidence": "string"
                }
            ]
        },
        "sourceOfFundsAndWealth": {
            "sourceOfFunds": {
                "types": [
                    "business_income"
                ],
                "otherDescription": "string"
            },
            "sourceOfWealth": {
                "types": [
                    "business_income"
                ],
                "otherDescription": "string"
            },
            "countryOfOriginOfFunds": "string"
        },
        "pepDetails": {
            "isPep": True,
            "pepInfo": {
                "name": "string",
                "positionOrRole": "string",
                "relationshipToEntity": "string",
                "countryOfPublicFunction": "string"
            },
            "hasRelatedPep": True,
            "relatedPepInfo": {
                "name": "string",
                "relationshipToEntity": "string",
                "positionOrRole": "string",
                "countryOfPublicFunction": "string"
            }
        },
        "servicesRequested": {
            "services": [
                "fund_management"
            ],
            "otherServiceDescription": "string",
            "relationshipPurpose": "string"
        },
        "documentsProvided": {
            "commercialLicense": "string",
            "certificateOfIncorporation": "string",
            "incumbencyOrShareRegister": "string",
            "moaAoa": "string",
            "trustDeed": "string",
            "foundationCharter": "string",
            "passportsOfUBOs": [
                "string"
            ],
            "proofOfAddress": "string",
            "vatCertificate": "string",
            "structureChart": "string",
            "poaIfApplicable": "string",
            "commercialLicenseAndCertificateOfIncorporation": [
                "string"
            ],
            "additionalDocuments": [
                "string"
            ]
        },
        "clientDeclaration": {
            "fullName": "string",
            "designation": "string",
            "companyName": "string",
            "signedAt": "string",
            "signatureAccepted": True
        }
    },
    "compliances": [
        {
            "condition": {
                "condition": "string",
                "checked": True
            },
            "description": "string"
        }
    ],
    "clientInformation": {
        "entityName": "string",
        "tradeName": "string",
        "legalStatus": "sole_proprietorship",
        "legalStatusOther": "string",
        "placeOfIncorporation": "string",
        "dateOfIncorporation": "string",
        "countryOfOperation": "string",
        "licenseNumber": "string",
        "licenseIssueDate": "string",
        "licenseExpiryDate": "string",
        "licenseIssuingAuthority": "string",
        "registrationNumber": "string",
        "vatRegistrationNumber": "string",
        "mainLicensedActivity": "string",
        "registeredAddress": "string",
        "contactPerson": {
            "name": "string",
            "phoneNumber": "string",
            "mobileNumber": "string",
            "designation": "string",
            "email": "user@example.com"
        },
        "communicationType": "face_to_face"
    },
    "ownershipAndControl": {
        "owners": [
            {
                "fullLegalName": "string",
                "nationality": "string",
                "countryOfRegistration": "string",
                "countryOfResidence": "string",
                "shareholdingPercentage": 0
            }
        ]
    },
    "managementDetails": {
        "directorsAndManagement": [
            {
                "fullName": "string",
                "designation": "string",
                "nationality": "string",
                "countryOfResidence": "string"
            }
        ]
    },
    "sourceOfFundsAndWealth": {
        "sourceOfFunds": {
            "types": [
                "business_income"
            ],
            "otherDescription": "string"
        },
        "sourceOfWealth": {
            "types": [
                "business_income"
            ],
            "otherDescription": "string"
        },
        "countryOfOriginOfFunds": "string"
    },
    "pepDetails": {
        "isPep": True,
        "pepInfo": {
            "name": "string",
            "positionOrRole": "string",
            "relationshipToEntity": "string",
            "countryOfPublicFunction": "string"
        },
        "hasRelatedPep": True,
        "relatedPepInfo": {
            "name": "string",
            "relationshipToEntity": "string",
            "positionOrRole": "string",
            "countryOfPublicFunction": "string"
        }
    },
    "servicesRequested": {
        "services": [
            "fund_management"
        ],
        "otherServiceDescription": "string",
        "relationshipPurpose": "string"
    },
    "documentsProvided": {
        "commercialLicense": "string",
        "certificateOfIncorporation": "string",
        "incumbencyOrShareRegister": "string",
        "moaAoa": "string",
        "trustDeed": "string",
        "foundationCharter": "string",
        "passportsOfUBOs": [
            "string"
        ],
        "proofOfAddress": "string",
        "vatCertificate": "string",
        "structureChart": "string",
        "poaIfApplicable": "string",
        "commercialLicenseAndCertificateOfIncorporation": [
            "string"
        ],
        "additionalDocuments": [
            "string"
        ]
    },
    "clientDeclaration": {
        "fullName": "string",
        "designation": "string",
        "companyName": "string",
        "signedAt": "string",
        "signatureAccepted": True
    },
    "isSubmitted": True
}

response = requests.patch(url, headers=headers, json=payload)
data = response.json()

Try request

Authentication

Bearer token

x-tenant-id

Path parameters

kybId string required

Request body

{
  "countryName": "string",
  "countryCode": "string",
  "registrationNumber": "string",
  "jurisdictionCode": "string",
  "companyName": "string",
  "verificationStatus": "pending",
  "submissionCompleted": true,
  "kybFormData": {
    "identity": "kyc",
    "compliances": [
      {
        "condition": {
          "condition": "string",
          "checked": true
        },
        "description": "string"
      }
    ],
    "clientInformation": {
      "entityName": "string",
      "tradeName": "string",
      "legalStatus": "sole_proprietorship",
      "legalStatusOther": "string",
      "placeOfIncorporation": "string",
      "dateOfIncorporation": "string",
      "countryOfOperation": "string",
      "licenseNumber": "string",
      "licenseIssueDate": "string",
      "licenseExpiryDate": "string",
      "licenseIssuingAuthority": "string",
      "registrationNumber": "string",
      "vatRegistrationNumber": "string",
      "mainLicensedActivity": "string",
      "registeredAddress": "string",
      "contactPerson": {
        "name": "string",
        "phoneNumber": "string",
        "mobileNumber": "string",
        "designation": "string",
        "email": "user@example.com"
      },
      "communicationType": "face_to_face"
    },
    "ownershipAndControl": {
      "owners": [
        {
          "fullLegalName": "string",
          "nationality": "string",
          "countryOfRegistration": "string",
          "countryOfResidence": "string",
          "shareholdingPercentage": 0
        }
      ]
    },
    "managementDetails": {
      "directorsAndManagement": [
        {
          "fullName": "string",
          "designation": "string",
          "nationality": "string",
          "countryOfResidence": "string"
        }
      ]
    },
    "sourceOfFundsAndWealth": {
      "sourceOfFunds": {
        "types": [
          "business_income"
        ],
        "otherDescription": "string"
      },
      "sourceOfWealth": {
        "types": [
          "business_income"
        ],
        "otherDescription": "string"
      },
      "countryOfOriginOfFunds": "string"
    },
    "pepDetails": {
      "isPep": true,
      "pepInfo": {
        "name": "string",
        "positionOrRole": "string",
        "relationshipToEntity": "string",
        "countryOfPublicFunction": "string"
      },
      "hasRelatedPep": true,
      "relatedPepInfo": {
        "name": "string",
        "relationshipToEntity": "string",
        "positionOrRole": "string",
        "countryOfPublicFunction": "string"
      }
    },
    "servicesRequested": {
      "services": [
        "fund_management"
      ],
      "otherServiceDescription": "string",
      "relationshipPurpose": "string"
    },
    "documentsProvided": {
      "commercialLicense": "string",
      "certificateOfIncorporation": "string",
      "incumbencyOrShareRegister": "string",
      "moaAoa": "string",
      "trustDeed": "string",
      "foundationCharter": "string",
      "passportsOfUBOs": [
        "string"
      ],
      "proofOfAddress": "string",
      "vatCertificate": "string",
      "structureChart": "string",
      "poaIfApplicable": "string",
      "commercialLicenseAndCertificateOfIncorporation": [
        "string"
      ],
      "additionalDocuments": [
        "string"
      ]
    },
    "clientDeclaration": {
      "fullName": "string",
      "designation": "string",
      "companyName": "string",
      "signedAt": "string",
      "signatureAccepted": true
    }
  },
  "compliances": [
    {
      "condition": {
        "condition": "string",
        "checked": true
      },
      "description": "string"
    }
  ],
  "clientInformation": {
    "entityName": "string",
    "tradeName": "string",
    "legalStatus": "sole_proprietorship",
    "legalStatusOther": "string",
    "placeOfIncorporation": "string",
    "dateOfIncorporation": "string",
    "countryOfOperation": "string",
    "licenseNumber": "string",
    "licenseIssueDate": "string",
    "licenseExpiryDate": "string",
    "licenseIssuingAuthority": "string",
    "registrationNumber": "string",
    "vatRegistrationNumber": "string",
    "mainLicensedActivity": "string",
    "registeredAddress": "string",
    "contactPerson": {
      "name": "string",
      "phoneNumber": "string",
      "mobileNumber": "string",
      "designation": "string",
      "email": "user@example.com"
    },
    "communicationType": "face_to_face"
  },
  "ownershipAndControl": {
    "owners": [
      {
        "fullLegalName": "string",
        "nationality": "string",
        "countryOfRegistration": "string",
        "countryOfResidence": "string",
        "shareholdingPercentage": 0
      }
    ]
  },
  "managementDetails": {
    "directorsAndManagement": [
      {
        "fullName": "string",
        "designation": "string",
        "nationality": "string",
        "countryOfResidence": "string"
      }
    ]
  },
  "sourceOfFundsAndWealth": {
    "sourceOfFunds": {
      "types": [
        "business_income"
      ],
      "otherDescription": "string"
    },
    "sourceOfWealth": {
      "types": [
        "business_income"
      ],
      "otherDescription": "string"
    },
    "countryOfOriginOfFunds": "string"
  },
  "pepDetails": {
    "isPep": true,
    "pepInfo": {
      "name": "string",
      "positionOrRole": "string",
      "relationshipToEntity": "string",
      "countryOfPublicFunction": "string"
    },
    "hasRelatedPep": true,
    "relatedPepInfo": {
      "name": "string",
      "relationshipToEntity": "string",
      "positionOrRole": "string",
      "countryOfPublicFunction": "string"
    }
  },
  "servicesRequested": {
    "services": [
      "fund_management"
    ],
    "otherServiceDescription": "string",
    "relationshipPurpose": "string"
  },
  "documentsProvided": {
    "commercialLicense": "string",
    "certificateOfIncorporation": "string",
    "incumbencyOrShareRegister": "string",
    "moaAoa": "string",
    "trustDeed": "string",
    "foundationCharter": "string",
    "passportsOfUBOs": [
      "string"
    ],
    "proofOfAddress": "string",
    "vatCertificate": "string",
    "structureChart": "string",
    "poaIfApplicable": "string",
    "commercialLicenseAndCertificateOfIncorporation": [
      "string"
    ],
    "additionalDocuments": [
      "string"
    ]
  },
  "clientDeclaration": {
    "fullName": "string",
    "designation": "string",
    "companyName": "string",
    "signedAt": "string",
    "signatureAccepted": true
  },
  "isSubmitted": true
}

Response · 200

# run the request to see the response