LegalEntity

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/LegalEntity",
  "title": "LegalEntity",
  "properties": {
    "capabilities": {
      "additionalProperties": {
        "$ref": "#/components/schemas/LegalEntityCapability"
      },
      "description": "Contains key-value pairs that specify the actions that the legal entity can do in your platform.The key is a capability required for your integration. For example, **issueCard** for Issuing.The value is an object containing the settings for the capability.",
      "readOnly": true,
      "type": "object"
    },
    "documentDetails": {
      "x-addedInVersion": "2",
      "description": "List of documents uploaded for the legal entity.",
      "items": {
        "$ref": "#/components/schemas/DocumentReference"
      },
      "type": "array"
    },
    "documents": {
      "deprecated": true,
      "x-deprecatedInVersion": "1",
      "x-deprecatedMessage": "Use the `documentDetails` array instead.",
      "description": "List of documents uploaded for the legal entity.",
      "items": {
        "$ref": "#/components/schemas/EntityReference"
      },
      "type": "array"
    },
    "entityAssociations": {
      "description": "List of legal entities associated with the current legal entity.\nFor example, ultimate beneficial owners associated with an organization through ownership or control, or as signatories.",
      "items": {
        "$ref": "#/components/schemas/LegalEntityAssociation"
      },
      "type": "array"
    },
    "id": {
      "description": "The unique identifier of the legal entity.",
      "readOnly": true,
      "type": "string"
    },
    "individual": {
      "description": "Information about the individual. Required if `type` is **individual**.",
      "$ref": "#/components/schemas/Individual"
    },
    "organization": {
      "description": "Information about the organization. Required if `type` is **organization**.",
      "$ref": "#/components/schemas/Organization"
    },
    "problems": {
      "x-addedInVersion": "3",
      "description": "List of verification errors related to capabilities for the legal entity.",
      "items": {
        "$ref": "#/components/schemas/CapabilityProblem"
      },
      "type": "array"
    },
    "reference": {
      "description": "Your reference for the legal entity, maximum 150 characters.",
      "maxLength": 150,
      "type": "string"
    },
    "soleProprietorship": {
      "x-addedInVersion": "2",
      "description": "Information about the sole proprietorship. Required if `type` is **soleProprietorship**.",
      "$ref": "#/components/schemas/SoleProprietorship"
    },
    "transferInstruments": {
      "description": "List of transfer instruments that the legal entity owns.",
      "items": {
        "$ref": "#/components/schemas/TransferInstrumentReference"
      },
      "readOnly": true,
      "type": "array"
    },
    "trust": {
      "description": "Information about the trust. Required if `type` is **trust**.",
      "$ref": "#/components/schemas/Trust"
    },
    "type": {
      "description": "The type of legal entity.\n\nPossible values: **individual**, **organization**, **soleProprietorship**, or **trust**.",
      "enum": [
        "individual",
        "organization",
        "soleProprietorship",
        "trust",
        "unincorporatedPartnership"
      ],
      "type": "string"
    },
    "unincorporatedPartnership": {
      "description": "Information about the unincorporated partnership. Required if `type` is **unincorporatedPartnership**.",
      "$ref": "#/components/schemas/UnincorporatedPartnership"
    },
    "verificationDeadlines": {
      "x-addedInVersion": "3",
      "description": "List of verification deadlines and the capabilities that will be disallowed if verification errors are not resolved.",
      "items": {
        "$ref": "#/components/schemas/VerificationDeadline"
      },
      "readOnly": true,
      "type": "array"
    },
    "verificationPlan": {
      "description": "A key-value pair that specifies the [verification process](https://docs.adyen.com/marketplaces-and-platforms/collect-verification-details/) for a legal entity. Set to **upfront** for [upfront verification](https://docs.adyen.com/marketplaces-and-platforms/collect-verification-details#upfront).",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}