Adyen · JSON Structure

Legal Entity Document Structure

Document schema from Adyen API

Type: object Properties: 13 Required: 2
PaymentsFinancial ServicesFintech

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

Properties

attachment attachments creationDate description expiryDate fileName id issuerCountry issuerState modificationDate number owner 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-document-structure.json",
  "description": "Document schema from Adyen API",
  "type": "object",
  "properties": {
    "attachment": {
      "deprecated": true,
      "x-deprecatedInVersion": "1",
      "x-deprecatedMessage": "Use the `attachments` array instead.",
      "description": "Object that contains the document.",
      "$ref": "#/components/schemas/Attachment"
    },
    "attachments": {
      "description": "Array that contains the document. The array supports multiple attachments for uploading different sides or pages of a document.",
      "items": {
        "$ref": "#/components/schemas/Attachment"
      },
      "type": "array"
    },
    "creationDate": {
      "description": "The creation date of the document.",
      "readOnly": true,
      "type": "datetime"
    },
    "description": {
      "description": "Your description for the document.",
      "type": "string"
    },
    "expiryDate": {
      "deprecated": true,
      "x-deprecatedInVersion": "1",
      "description": "The expiry date of the document, in YYYY-MM-DD format.",
      "type": "string"
    },
    "fileName": {
      "description": "The filename of the document.",
      "type": "string"
    },
    "id": {
      "description": "The unique identifier of the document.",
      "readOnly": true,
      "type": "string"
    },
    "issuerCountry": {
      "deprecated": true,
      "x-deprecatedInVersion": "1",
      "description": "The two-character [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code where the document was issued. For example, **US**.",
      "type": "string"
    },
    "issuerState": {
      "deprecated": true,
      "x-deprecatedInVersion": "1",
      "description": "The state or province where the document was issued (AU only).",
      "type": "string"
    },
    "modificationDate": {
      "description": "The modification date of the document.",
      "readOnly": true,
      "type": "datetime"
    },
    "number": {
      "description": "The number in the document.",
      "type": "string"
    },
    "owner": {
      "description": "Contains information about the resource that owns the document.",
      "$ref": "#/components/schemas/OwnerEntity"
    },
    "type": {
      "description": "Type of document, used when providing an ID number or uploading a document. The possible values depend on the legal entity type.\n\n* For **organization**, the `type` values can be **proofOfAddress**, **registrationDocument**, **vatDocument**, **proofOfOrganizationTaxInfo**, **proofOfOwnership**, **proofOfIndustry**, or **proofOfFundingOrWealthSource**.\n\n* For **individual**, the `type` values can be **identityCard**, **driversLicense**, **passport**, **proofOfNationalIdNumber**, **proofOfResidency**, **proofOfIndustry**, **proofOfIndividualTaxId**, or **proofOfFundingOrWealthSource**.\n\n* For **soleProprietorship**, the `type` values can be **constitutionalDocument**, **proofOfAddress**, or **proofOfIndustry**.\n\n* Use **bankStatement** to upload documents for a [transfer instrument](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/transferInstruments__resParam_id).",
      "enum": [
        "bankStatement",
        "driversLicense",
        "identityCard",
        "nationalIdNumber",
        "passport",
        "proofOfAddress",
        "proofOfNationalIdNumber",
        "proofOfResidency",
        "registrationDocument",
        "vatDocument",
        "proofOfOrganizationTaxInfo",
        "proofOfIndustry",
        "constitutionalDocument",
        "proofOfFundingOrWealthSource"
      ],
      "type": "string"
    }
  },
  "required": [
    "description",
    "type"
  ],
  "name": "Document"
}