Adyen · Schema

Organization

PaymentsFinancial ServicesFintech

Properties

Name Type Description
dateOfIncorporation string The date when the organization was incorporated in YYYY-MM-DD format.
description string Your description for the organization.
doingBusinessAs string The organization's trading name, if different from the registered legal name.
email string The email address of the legal entity.
legalName string The organization's legal name.
phone object The phone number of the legal entity.
principalPlaceOfBusiness object The address where the organization operates from. Provide this if the principal place of business is different from the `registeredAddress`.
registeredAddress object The address of the organization registered at their registrar (such as the Chamber of Commerce).
registrationNumber string The organization's registration number.
stockData object Information about the organization's publicly traded stock. Provide this object only if `type` is **listedPublicCompany**.
taxInformation array The tax information of the organization.
taxReportingClassification object The tax reporting classification (FATCA/CRS self-certification) of the organization.
type string Type of organization. Possible values: **associationIncorporated**, **governmentalOrganization**, **listedPublicCompany**, **nonProfit**, **partnershipIncorporated**, **privateCompany**.
vatAbsenceReason string The reason the organization has not provided a VAT number. Possible values: **industryExemption**, **belowTaxThreshold**.
vatNumber string The organization's VAT number.
webData object The website and app URL of the legal entity.
View JSON Schema on GitHub

JSON Schema

adyen-organization-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/Organization",
  "title": "Organization",
  "properties": {
    "dateOfIncorporation": {
      "x-addedInVersion": "2",
      "description": "The date when the organization was incorporated in YYYY-MM-DD format.",
      "type": "string"
    },
    "description": {
      "description": "Your description for the organization.",
      "type": "string"
    },
    "doingBusinessAs": {
      "description": "The organization's trading name, if different from the registered legal name.",
      "type": "string"
    },
    "email": {
      "description": "The email address of the legal entity.",
      "type": "string"
    },
    "legalName": {
      "description": "The organization's legal name.",
      "type": "string"
    },
    "phone": {
      "description": "The phone number of the legal entity.",
      "$ref": "#/components/schemas/PhoneNumber"
    },
    "principalPlaceOfBusiness": {
      "description": "The address where the organization operates from. Provide this if the principal place of business is different from the `registeredAddress`.",
      "$ref": "#/components/schemas/Address"
    },
    "registeredAddress": {
      "description": "The address of the organization registered at their registrar (such as the Chamber of Commerce).",
      "$ref": "#/components/schemas/Address"
    },
    "registrationNumber": {
      "description": "The organization's registration number.",
      "type": "string"
    },
    "stockData": {
      "description": "Information about the organization's publicly traded stock. Provide this object only if `type` is **listedPublicCompany**.",
      "$ref": "#/components/schemas/StockData"
    },
    "taxInformation": {
      "x-addedInVersion": "2",
      "description": "The tax information of the organization.",
      "items": {
        "$ref": "#/components/schemas/TaxInformation"
      },
      "type": "array"
    },
    "taxReportingClassification": {
      "x-addedInVersion": "2",
      "description": "The tax reporting classification (FATCA/CRS self-certification) of the organization.",
      "$ref": "#/components/schemas/TaxReportingClassification"
    },
    "type": {
      "description": "Type of organization.\n\nPossible values: **associationIncorporated**, **governmentalOrganization**, **listedPublicCompany**, **nonProfit**, **partnershipIncorporated**, **privateCompany**.",
      "enum": [
        "associationIncorporated",
        "governmentalOrganization",
        "listedPublicCompany",
        "nonProfit",
        "partnershipIncorporated",
        "privateCompany"
      ],
      "type": "string"
    },
    "vatAbsenceReason": {
      "x-addedInVersion": "2",
      "description": "The reason the organization has not provided a VAT number.\n\nPossible values: **industryExemption**, **belowTaxThreshold**.",
      "enum": [
        "industryExemption",
        "belowTaxThreshold"
      ],
      "type": "string"
    },
    "vatNumber": {
      "x-addedInVersion": "2",
      "description": "The organization's VAT number.",
      "type": "string"
    },
    "webData": {
      "deprecated": true,
      "x-deprecatedInVersion": "1",
      "description": "The website and app URL of the legal entity.",
      "$ref": "#/components/schemas/WebData"
    }
  },
  "required": [
    "legalName",
    "registeredAddress"
  ],
  "type": "object"
}