Adyen · JSON Structure

Legal Entity Legal Entity Association Structure

LegalEntityAssociation schema from Adyen API

Type: object Properties: 7 Required: 2
PaymentsFinancial ServicesFintech

LegalEntityAssociation is a JSON Structure definition published by Adyen, describing 7 properties, of which 2 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

associatorId entityType jobTitle legalEntityId name settlorExemptionReason type

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/adyen/refs/heads/main/json-structure/legal-entity-legal-entity-association-structure.json",
  "description": "LegalEntityAssociation schema from Adyen API",
  "type": "object",
  "properties": {
    "associatorId": {
      "description": "The unique identifier of another legal entity with which the `legalEntityId` is associated. When the `legalEntityId` is associated to legal entities other than the current one, the response returns all the associations.",
      "readOnly": true,
      "type": "string"
    },
    "entityType": {
      "description": "The legal entity type of associated legal entity.\n\nFor example, **organization**, **soleProprietorship** or **individual**.",
      "readOnly": true,
      "type": "string"
    },
    "jobTitle": {
      "description": "The individual's job title if the `type` is **uboThroughControl** or **signatory**.",
      "type": "string"
    },
    "legalEntityId": {
      "description": "The unique identifier of the associated [legal entity](https://docs.adyen.com/api-explorer/legalentity/latest/post/legalEntities#responses-200-id).",
      "type": "string"
    },
    "name": {
      "description": "The name of the associated [legal entity](https://docs.adyen.com/api-explorer/legalentity/latest/post/legalEntities#responses-200-id).\n\n- For **individual**, `name.firstName` and `name.lastName`.\n- For **organization**, `legalName`.\n- For **soleProprietorship**, `name`.",
      "readOnly": true,
      "type": "string"
    },
    "settlorExemptionReason": {
      "description": "Defines the Kyc Exemption Reason for a Settlor associated with a trust.\n\nFor example, **professionalServiceProvider**, **deceased**, or **contributionBelowThreshold**.",
      "items": {
        "type": "string"
      },
      "readOnly": true,
      "type": "array"
    },
    "type": {
      "description": "Defines the relationship of the legal entity to the current legal entity.\n\nPossible values for organizations: **uboThroughOwnership**, **uboThroughControl**, **director**, **signatory**, or **ultimateParentCompany**.\n\nPossible values for sole proprietorships: **soleProprietorship**.\n\nPossible value for trusts: **trust**\n\nPossible values for trust members: **definedBeneficiary**, **protector**, **secondaryTrustee**, **settlor**, **uboThroughControl**, or **uboThroughOwnership**.",
      "enum": [
        "definedBeneficiary",
        "director",
        "pciSignatory",
        "protector",
        "secondaryTrustee",
        "settlor",
        "signatory",
        "soleProprietorship",
        "trust",
        "trustOwnership",
        "uboThroughControl",
        "uboThroughOwnership",
        "ultimateParentCompany",
        "undefinedBeneficiary"
      ],
      "type": "string"
    }
  },
  "required": [
    "legalEntityId",
    "type"
  ],
  "name": "LegalEntityAssociation"
}