Skip to main content

Company Association

In the process of company onboarding, we need to add company associations. This includes adding associated parties, beneficial owners, and other company-related information.

Create Company Association​

/v1/company-association

Sample Request​

{
  "customerId": "84ee11bb-9834-42a8-aac3-89ef026d640e",
  "associatedParties": [
    {
      "associatedPartyTypes": [
        "FORMATION_OFFICER",
        "EXECUTIVE_OFFICER",
        "BENEFICIAL_OWNER",
        "SIGNATORY"
      ],
      "profile": {
        "ownershipType": "DIRECTLY",
        "shareOwnership": 10,
        "firstName": "Lucio",
        "middleName": "",
        "lastName": "Legros",
        "isUsPerson": true,
        "dateOfBirth": "1996-04-22T08:37:49.375Z",
        "ssn": "905812336",
        "taxCountry": "US",
        "taxState": "AL",
        "phoneNumber": "+1 8155548967",
        "email": "Luigi29@example.com",
        "nonUsTaxIdInfo": {
          "passportId": {
            "documentType": "PASSPORT",
            "uploadedDocumentId": "e6c8447c-e5f8-425c-b274-549eee02e559"
          },
          "countryOfIssuance": "US",
          "passportNumber": "439547374"
        }
      },
      "beneficialOwnerId": "4f81d014-3bf4-4c1d-83ea-3968e9000cb8",
      "isIndividualOwner": true,
      "primaryResidentialAddress": {
        "countryCode": "US",
        "street1": "12022",
        "street2": "fjdfd",
        "city": "Mos",
        "state": "AL",
        "postalCode": "98101"
      },
      "occupation": "occupation",
      "occupationTitle": "Occupation Title",
      "primaryBusinessAddress": {
        "countryCode": "US",
        "street1": "12022",
        "street2": "fjdfd",
        "city": "Mos",
        "state": "AL",
        "postalCode": "98101"
      },
      "isHaveRelationWithPEP": false,
      "countryOfPEP": "US",
      "relationWithPEP": "None",
      "hasCertification": true,
      "certificationDetails": "some details",
      "identificationDoc": {
        "documentType": "PASSPORT",
        "uploadedDocumentId": "e6c8447c-e5f8-425c-b274-549eee02e559"
      },
      "proofOfAddressDoc": {
        "documentType": "UTILITY_BILL",
        "uploadedDocumentId": "e6c8447c-e5f8-425c-b274-549eee02e559"
      },
      "businessEntityFormationAndGoverningDocs": [
        {
          "documentType": "document type",
          "uploadedDocumentId": "e6c8447c-e5f8-425c-b274-549eee02e559"
        }
      ]
    }
  ],
  "beneficialOwnerCertification": {
    "name": "Jhon",
    "signature": "Jhon",
    "date": "2024-07-26T08:37:49.375Z",
    "entityIdentifier": "123124123"
  }
}

Sample Response​

{
  "companyAssociations": {
    "customerId": "84ee11bb-9834-42a8-aac3-89ef026d640e",
    "associatedPartyIds": ["7ba42b34-6f3f-4fa4-a675-d8efb38f3436"],
    "beneficialOwnerCertification": {
      "name": "Jhon",
      "signature": "Jhon",
      "date": "2024-07-26T08:37:49.375Z",
      "entityIdentifier": "123124123"
    },
    "pendingActions": [],
    "createdAt": "2024-08-02T12:05:44.076Z",
    "updatedAt": "2024-08-02T12:05:48.274Z",
    "__v": 0,
    "id": "1f64a05a-8c50-486f-a17e-47473e23277e"
  },
  "associatedParties": [
    {
      "companyAssociationId": "1f64a05a-8c50-486f-a17e-47473e23277e",
      "customerId": "84ee11bb-9834-42a8-aac3-89ef026d640e",
      "beneficialOwnerId": "4f81d014-3bf4-4c1d-83ea-3968e9000cb8",
      "isIndividualOwner": true,
      "associatedPartyTypes": [
        "FORMATION_OFFICER",
        "EXECUTIVE_OFFICER",
        "BENEFICIAL_OWNER",
        "SIGNATORY"
      ],
      "primaryResidentialAddress": {
        "countryCode": "US",
        "street1": "12022",
        "street2": "fjdfd",
        "city": "Mos",
        "state": "AL",
        "postalCode": "98101"
      },
      "occupation": "occupation",
      "occupationTitle": "Occupation Title",
      "proofOfAddressDoc": {
        "documentType": "UTILITY_BILL",
        "uploadedDocumentId": "e6c8447c-e5f8-425c-b274-549eee02e559",
        "frontSideUrl": "https://cbms-alpha-docs.s3.us-east-2.amazonaws.com/84ee11bb-9834-42a8-aac3-89ef026d640e/-30c8e9cb-5977-4533-b741-dbba44cb9f6c.pdf"
      },
      "identificationDoc": {
        "documentType": "PASSPORT",
        "uploadedDocumentId": "e6c8447c-e5f8-425c-b274-549eee02e559",
        "frontSideUrl": "https://cbms-alpha-docs.s3.us-east-2.amazonaws.com/84ee11bb-9834-42a8-aac3-89ef026d640e/-30c8e9cb-5977-4533-b741-dbba44cb9f6c.pdf"
      },
      "isHaveRelationWithPEP": false,
      "countryOfPEP": "US",
      "relationWithPEP": "None",
      "hasCertification": true,
      "certificationDetails": "some details",
      "pendingActions": [],
      "businessEntityFormationAndGoverningDocs": [],
      "createdAt": "2024-08-02T12:05:45.996Z",
      "updatedAt": "2024-08-02T12:05:45.996Z",
      "__v": 0,
      "profile": {
        "ownershipType": "DIRECTLY",
        "shareOwnership": 10,
        "firstName": "Lucio",
        "middleName": "",
        "lastName": "Legros",
        "isUsPerson": true,
        "dateOfBirth": "1996-04-22T08:37:49.375Z",
        "ssn": "905811336",
        "nonUsTaxIdInfo": {
          "passportNumber": "439547374",
          "countryOfIssuance": "US",
          "passportId": {
            "documentType": "PASSPORT",
            "uploadedDocumentId": "e6c8447c-e5f8-425c-b274-549eee02e559",
            "frontSideUrl": "https://cbms-alpha-docs.s3.us-east-2.amazonaws.com/84ee11bb-9834-42a8-aac3-89ef026d640e/-30c8e9cb-5977-4533-b741-dbba44cb9f6c.pdf"
          }
        },
        "taxCountry": "US",
        "taxState": "AL",
        "phoneNumber": "+1 8155538967",
        "email": "Luigi29@example.com",
        "_id": "66accb99b2c478927fdb0bd8"
      },
      "id": "7ba42b34-6f3f-4fa4-a675-d8efb38f3436"
    }
  ]
}