Adyen · JSON Structure

Legal Entity Address Structure

Address schema from Adyen API

Type: object Properties: 6 Required: 1
PaymentsFinancial ServicesFintech

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

Properties

city country postalCode stateOrProvince street street2

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-address-structure.json",
  "description": "Address schema from Adyen API",
  "type": "object",
  "properties": {
    "city": {
      "description": "The name of the city. Required if `stateOrProvince` is provided.\n\nIf you specify the city, you must also send `postalCode` and `street`.",
      "type": "string"
    },
    "country": {
      "description": "The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.",
      "type": "string"
    },
    "postalCode": {
      "description": "Postal code. Required if `stateOrProvince` and/or `city` is provided.",
      "type": "string"
    },
    "stateOrProvince": {
      "description": "The two-letter ISO 3166-2 state or province code. For example, **CA** in the US.\n\nIf you specify the state or province, you must also send `city`, `postalCode`, and `street`.",
      "type": "string"
    },
    "street": {
      "description": "The name of the street, and the house or building number. Required if `stateOrProvince` and/or `city` is provided.",
      "type": "string"
    },
    "street2": {
      "description": "The apartment, unit, or suite number.",
      "type": "string"
    }
  },
  "required": [
    "country"
  ],
  "name": "Address"
}