action increase_create_an_entity {
  label: "Create an Entity"
  provider: increase
  method: POST
  path: "/entities"
  encoding: json
  input: {
    type: "object"
    required: ["relationship", "structure"]
    properties: {
      corporation: {
        type: "object"
        description: "Details of the corporation entity to create. Required if `structure` is equal to `corporation`."
        required: ["address", "beneficial_owners", "name", "tax_identifier"]
        properties: {
          address: {
            type: "object"
            description: "The corporation's address."
            required: ["city", "line1", "state", "zip"]
            properties: {
              city: {
                type: "string"
                description: "The city of the address."
              }
              line1: {
                type: "string"
                description: "The first line of the address. This is usually the street number and street."
              }
              line2: {
                type: "string"
                description: "The second line of the address. This might be the floor or room number."
              }
              state: {
                type: "string"
                description: "The two-letter United States Postal Service (USPS) abbreviation for the state of the address."
              }
              zip: {
                type: "string"
                description: "The ZIP code of the address."
              }
            }
          }
          beneficial_owners: {
            type: "array"
            description: "The identifying details of anyone controlling or owning 25% or more of the corporation."
            items: {
              type: "object"
              required: ["individual", "prong"]
              properties: {
                company_title: {
                  type: "string"
                  description: "This person's role or title within the entity."
                }
                individual: {
                  type: "object"
                  description: "Personal details for the beneficial owner."
                  required: ["name", "date_of_birth", "address", "identification"]
                  properties: {
                    address: {
                      type: "object"
                      description: "The individual's address."
                      required: ["line1", "city", "state", "zip"]
                      properties: {
                        city: {
                          type: "string"
                          description: "The city of the address."
                        }
                        line1: {
                          type: "string"
                          description: "The first line of the address. This is usually the street number and street."
                        }
                        line2: {
                          type: "string"
                          description: "The second line of the address. This might be the floor or room number."
                        }
                        state: {
                          type: "string"
                          description: "The two-letter United States Postal Service (USPS) abbreviation for the state of the address."
                        }
                        zip: {
                          type: "string"
                          description: "The ZIP code of the address."
                        }
                      }
                    }
                    confirmed_no_us_tax_id: {
                      type: "boolean"
                      description: "The identification method for an individual can only be a passport, driver's license, or other document if you've confirmed the individual does not have a US tax id (either a Social Security Number or Individual Taxpayer Identification Number)."
                    }
                    date_of_birth: {
                      type: "string"
                      format: "date"
                      description: "The person's date of birth in YYYY-MM-DD format."
                    }
                    identification: {
                      type: "object"
                      description: "A means of verifying the person's identity."
                      required: ["method", "number"]
                      properties: {
                        drivers_license: {
                          type: "object"
                          description: "Information about the United States driver's license used for identification. Required if `method` is equal to `drivers_license`."
                          required: ["file_id", "expiration_date", "state"]
                          properties: {
                            expiration_date: {
                              type: "string"
                              format: "date"
                              description: "The driver's license's expiration date in YYYY-MM-DD format."
                            }
                            file_id: {
                              type: "string"
                              description: "The identifier of the File containing the driver's license."
                            }
                            state: {
                              type: "string"
                              description: "The state that issued the provided driver's license."
                            }
                          }
                        }
                        method: {
                          type: "string"
                          description: "A method that can be used to verify the individual's identity."
                          enum: ["social_security_number", "individual_taxpayer_identification_number", "passport", "drivers_license", "other"]
                        }
                        number: {
                          type: "string"
                          description: "An identification number that can be used to verify the individual's identity, such as a social security number."
                        }
                        other: {
                          type: "object"
                          description: "Information about the identification document provided. Required if `method` is equal to `other`."
                          required: ["country", "description", "file_id"]
                          properties: {
                            country: {
                              type: "string"
                              description: "The two-character ISO 3166-1 code representing the country that issued the document."
                            }
                            description: {
                              type: "string"
                              description: "A description of the document submitted."
                            }
                            expiration_date: {
                              type: "string"
                              format: "date"
                              description: "The document's expiration date in YYYY-MM-DD format."
                            }
                            file_id: {
                              type: "string"
                              description: "The identifier of the File containing the document."
                            }
                          }
                        }
                        passport: {
                          type: "object"
                          description: "Information about the passport used for identification. Required if `method` is equal to `passport`."
                          required: ["file_id", "expiration_date", "country"]
                          properties: {
                            country: {
                              type: "string"
                              description: "The country that issued the passport."
                            }
                            expiration_date: {
                              type: "string"
                              format: "date"
                              description: "The passport's expiration date in YYYY-MM-DD format."
                            }
                            file_id: {
                              type: "string"
                              description: "The identifier of the File containing the passport."
                            }
                          }
                        }
                      }
                    }
                    name: {
                      type: "string"
                      description: "The person's legal name."
                    }
                  }
                }
                prong: {
                  type: "string"
                  description: "Why this person is considered a beneficial owner of the entity."
                  enum: ["ownership", "control"]
                }
              }
            }
          }
          incorporation_state: {
            type: "string"
            description: "The two-letter United States Postal Service (USPS) abbreviation for the corporation's state of incorporation."
          }
          name: {
            type: "string"
            description: "The legal name of the corporation."
          }
          tax_identifier: {
            type: "string"
            description: "The Employer Identification Number (EIN) for the corporation."
          }
          website: {
            type: "string"
            description: "The website of the corporation."
          }
        }
      }
      description: {
        type: "string"
        description: "The description you choose to give the entity."
      }
      joint: {
        type: "object"
        description: "Details of the joint entity to create. Required if `structure` is equal to `joint`."
        required: ["individuals"]
        properties: {
          individuals: {
            type: "array"
            description: "The two individuals that share control of the entity."
            items: {
              type: "object"
              required: ["name", "date_of_birth", "address", "identification"]
              properties: {
                address: {
                  type: "object"
                  description: "The individual's address."
                  required: ["line1", "city", "state", "zip"]
                  properties: {
                    city: {
                      type: "string"
                      description: "The city of the address."
                    }
                    line1: {
                      type: "string"
                      description: "The first line of the address. This is usually the street number and street."
                    }
                    line2: {
                      type: "string"
                      description: "The second line of the address. This might be the floor or room number."
                    }
                    state: {
                      type: "string"
                      description: "The two-letter United States Postal Service (USPS) abbreviation for the state of the address."
                    }
                    zip: {
                      type: "string"
                      description: "The ZIP code of the address."
                    }
                  }
                }
                confirmed_no_us_tax_id: {
                  type: "boolean"
                  description: "The identification method for an individual can only be a passport, driver's license, or other document if you've confirmed the individual does not have a US tax id (either a Social Security Number or Individual Taxpayer Identification Number)."
                }
                date_of_birth: {
                  type: "string"
                  format: "date"
                  description: "The person's date of birth in YYYY-MM-DD format."
                }
                identification: {
                  type: "object"
                  description: "A means of verifying the person's identity."
                  required: ["method", "number"]
                  properties: {
                    drivers_license: {
                      type: "object"
                      description: "Information about the United States driver's license used for identification. Required if `method` is equal to `drivers_license`."
                      required: ["file_id", "expiration_date", "state"]
                      properties: {
                        expiration_date: {
                          type: "string"
                          format: "date"
                          description: "The driver's license's expiration date in YYYY-MM-DD format."
                        }
                        file_id: {
                          type: "string"
                          description: "The identifier of the File containing the driver's license."
                        }
                        state: {
                          type: "string"
                          description: "The state that issued the provided driver's license."
                        }
                      }
                    }
                    method: {
                      type: "string"
                      description: "A method that can be used to verify the individual's identity."
                      enum: ["social_security_number", "individual_taxpayer_identification_number", "passport", "drivers_license", "other"]
                    }
                    number: {
                      type: "string"
                      description: "An identification number that can be used to verify the individual's identity, such as a social security number."
                    }
                    other: {
                      type: "object"
                      description: "Information about the identification document provided. Required if `method` is equal to `other`."
                      required: ["country", "description", "file_id"]
                      properties: {
                        country: {
                          type: "string"
                          description: "The two-character ISO 3166-1 code representing the country that issued the document."
                        }
                        description: {
                          type: "string"
                          description: "A description of the document submitted."
                        }
                        expiration_date: {
                          type: "string"
                          format: "date"
                          description: "The document's expiration date in YYYY-MM-DD format."
                        }
                        file_id: {
                          type: "string"
                          description: "The identifier of the File containing the document."
                        }
                      }
                    }
                    passport: {
                      type: "object"
                      description: "Information about the passport used for identification. Required if `method` is equal to `passport`."
                      required: ["file_id", "expiration_date", "country"]
                      properties: {
                        country: {
                          type: "string"
                          description: "The country that issued the passport."
                        }
                        expiration_date: {
                          type: "string"
                          format: "date"
                          description: "The passport's expiration date in YYYY-MM-DD format."
                        }
                        file_id: {
                          type: "string"
                          description: "The identifier of the File containing the passport."
                        }
                      }
                    }
                  }
                }
                name: {
                  type: "string"
                  description: "The person's legal name."
                }
              }
            }
          }
          name: {
            type: "string"
            description: "The name of the joint entity."
          }
        }
      }
      natural_person: {
        type: "object"
        description: "Details of the natural person entity to create. Required if `structure` is equal to `natural_person`. Natural people entities should be submitted with `social_security_number` or `individual_taxpayer_identification_number` identification methods."
        required: ["address", "date_of_birth", "identification", "name"]
        properties: {
          address: {
            type: "object"
            description: "The individual's address."
            required: ["city", "line1", "state", "zip"]
            properties: {
              city: {
                type: "string"
                description: "The city of the address."
              }
              line1: {
                type: "string"
                description: "The first line of the address. This is usually the street number and street."
              }
              line2: {
                type: "string"
                description: "The second line of the address. This might be the floor or room number."
              }
              state: {
                type: "string"
                description: "The two-letter United States Postal Service (USPS) abbreviation for the state of the address."
              }
              zip: {
                type: "string"
                description: "The ZIP code of the address."
              }
            }
          }
          confirmed_no_us_tax_id: {
            type: "boolean"
            description: "The identification method for an individual can only be a passport, driver's license, or other document if you've confirmed the individual does not have a US tax id (either a Social Security Number or Individual Taxpayer Identification Number)."
          }
          date_of_birth: {
            type: "string"
            format: "date"
            description: "The person's date of birth in YYYY-MM-DD format."
          }
          identification: {
            type: "object"
            description: "A means of verifying the person's identity."
            required: ["method", "number"]
            properties: {
              drivers_license: {
                type: "object"
                description: "Information about the United States driver's license used for identification. Required if `method` is equal to `drivers_license`."
                required: ["expiration_date", "file_id", "state"]
                properties: {
                  expiration_date: {
                    type: "string"
                    format: "date"
                    description: "The driver's license's expiration date in YYYY-MM-DD format."
                  }
                  file_id: {
                    type: "string"
                    description: "The identifier of the File containing the driver's license."
                  }
                  state: {
                    type: "string"
                    description: "The state that issued the provided driver's license."
                  }
                }
              }
              method: {
                type: "string"
                description: "A method that can be used to verify the individual's identity."
                enum: ["social_security_number", "individual_taxpayer_identification_number", "passport", "drivers_license", "other"]
              }
              number: {
                type: "string"
                description: "An identification number that can be used to verify the individual's identity, such as a social security number."
              }
              other: {
                type: "object"
                description: "Information about the identification document provided. Required if `method` is equal to `other`."
                required: ["country", "description", "file_id"]
                properties: {
                  country: {
                    type: "string"
                    description: "The two-character ISO 3166-1 code representing the country that issued the document."
                  }
                  description: {
                    type: "string"
                    description: "A description of the document submitted."
                  }
                  expiration_date: {
                    type: "string"
                    format: "date"
                    description: "The document's expiration date in YYYY-MM-DD format."
                  }
                  file_id: {
                    type: "string"
                    description: "The identifier of the File containing the document."
                  }
                }
              }
              passport: {
                type: "object"
                description: "Information about the passport used for identification. Required if `method` is equal to `passport`."
                required: ["country", "expiration_date", "file_id"]
                properties: {
                  country: {
                    type: "string"
                    description: "The country that issued the passport."
                  }
                  expiration_date: {
                    type: "string"
                    format: "date"
                    description: "The passport's expiration date in YYYY-MM-DD format."
                  }
                  file_id: {
                    type: "string"
                    description: "The identifier of the File containing the passport."
                  }
                }
              }
            }
          }
          name: {
            type: "string"
            description: "The person's legal name."
          }
        }
      }
      relationship: {
        type: "string"
        description: "The relationship between your group and the entity."
        enum: ["affiliated", "informational", "unaffiliated"]
      }
      structure: {
        type: "string"
        description: "The type of Entity to create."
        enum: ["corporation", "natural_person", "joint", "trust"]
      }
      supplemental_documents: {
        type: "array"
        description: "Additional documentation associated with the entity."
        items: {
          type: "object"
          required: ["file_id"]
          properties: {
            file_id: {
              type: "string"
              description: "The identifier of the File containing the document."
            }
          }
        }
      }
      trust: {
        type: "object"
        description: "Details of the trust entity to create. Required if `structure` is equal to `trust`."
        required: ["address", "category", "name", "trustees"]
        properties: {
          address: {
            type: "object"
            description: "The trust's address."
            required: ["city", "line1", "state", "zip"]
            properties: {
              city: {
                type: "string"
                description: "The city of the address."
              }
              line1: {
                type: "string"
                description: "The first line of the address. This is usually the street number and street."
              }
              line2: {
                type: "string"
                description: "The second line of the address. This might be the floor or room number."
              }
              state: {
                type: "string"
                description: "The two-letter United States Postal Service (USPS) abbreviation for the state of the address."
              }
              zip: {
                type: "string"
                description: "The ZIP code of the address."
              }
            }
          }
          category: {
            type: "string"
            description: "Whether the trust is `revocable` or `irrevocable`. Irrevocable trusts require their own Employer Identification Number. Revocable trusts require information about the individual `grantor` who created the trust."
            enum: ["revocable", "irrevocable"]
          }
          formation_document_file_id: {
            type: "string"
            description: "The identifier of the File containing the formation document of the trust."
          }
          formation_state: {
            type: "string"
            description: "The two-letter United States Postal Service (USPS) abbreviation for the state in which the trust was formed."
          }
          grantor: {
            type: "object"
            description: "The grantor of the trust. Required if `category` is equal to `revocable`."
            required: ["address", "date_of_birth", "identification", "name"]
            properties: {
              address: {
                type: "object"
                description: "The individual's address."
                required: ["city", "line1", "state", "zip"]
                properties: {
                  city: {
                    type: "string"
                    description: "The city of the address."
                  }
                  line1: {
                    type: "string"
                    description: "The first line of the address. This is usually the street number and street."
                  }
                  line2: {
                    type: "string"
                    description: "The second line of the address. This might be the floor or room number."
                  }
                  state: {
                    type: "string"
                    description: "The two-letter United States Postal Service (USPS) abbreviation for the state of the address."
                  }
                  zip: {
                    type: "string"
                    description: "The ZIP code of the address."
                  }
                }
              }
              confirmed_no_us_tax_id: {
                type: "boolean"
                description: "The identification method for an individual can only be a passport, driver's license, or other document if you've confirmed the individual does not have a US tax id (either a Social Security Number or Individual Taxpayer Identification Number)."
              }
              date_of_birth: {
                type: "string"
                format: "date"
                description: "The person's date of birth in YYYY-MM-DD format."
              }
              identification: {
                type: "object"
                description: "A means of verifying the person's identity."
                required: ["method", "number"]
                properties: {
                  drivers_license: {
                    type: "object"
                    description: "Information about the United States driver's license used for identification. Required if `method` is equal to `drivers_license`."
                    required: ["expiration_date", "file_id", "state"]
                    properties: {
                      expiration_date: {
                        type: "string"
                        format: "date"
                        description: "The driver's license's expiration date in YYYY-MM-DD format."
                      }
                      file_id: {
                        type: "string"
                        description: "The identifier of the File containing the driver's license."
                      }
                      state: {
                        type: "string"
                        description: "The state that issued the provided driver's license."
                      }
                    }
                  }
                  method: {
                    type: "string"
                    description: "A method that can be used to verify the individual's identity."
                    enum: ["social_security_number", "individual_taxpayer_identification_number", "passport", "drivers_license", "other"]
                  }
                  number: {
                    type: "string"
                    description: "An identification number that can be used to verify the individual's identity, such as a social security number."
                  }
                  other: {
                    type: "object"
                    description: "Information about the identification document provided. Required if `method` is equal to `other`."
                    required: ["country", "description", "file_id"]
                    properties: {
                      country: {
                        type: "string"
                        description: "The two-character ISO 3166-1 code representing the country that issued the document."
                      }
                      description: {
                        type: "string"
                        description: "A description of the document submitted."
                      }
                      expiration_date: {
                        type: "string"
                        format: "date"
                        description: "The document's expiration date in YYYY-MM-DD format."
                      }
                      file_id: {
                        type: "string"
                        description: "The identifier of the File containing the document."
                      }
                    }
                  }
                  passport: {
                    type: "object"
                    description: "Information about the passport used for identification. Required if `method` is equal to `passport`."
                    required: ["country", "expiration_date", "file_id"]
                    properties: {
                      country: {
                        type: "string"
                        description: "The country that issued the passport."
                      }
                      expiration_date: {
                        type: "string"
                        format: "date"
                        description: "The passport's expiration date in YYYY-MM-DD format."
                      }
                      file_id: {
                        type: "string"
                        description: "The identifier of the File containing the passport."
                      }
                    }
                  }
                }
              }
              name: {
                type: "string"
                description: "The person's legal name."
              }
            }
          }
          name: {
            type: "string"
            description: "The legal name of the trust."
          }
          tax_identifier: {
            type: "string"
            description: "The Employer Identification Number (EIN) for the trust. Required if `category` is equal to `irrevocable`."
          }
          trustees: {
            type: "array"
            description: "The trustees of the trust."
            items: {
              type: "object"
              required: ["structure"]
              properties: {
                individual: {
                  type: "object"
                  description: "Details of the individual trustee. Required when the trustee `structure` is equal to `individual`."
                  required: ["name", "date_of_birth", "address", "identification"]
                  properties: {
                    address: {
                      type: "object"
                      description: "The individual's address."
                      required: ["line1", "city", "state", "zip"]
                      properties: {
                        city: {
                          type: "string"
                          description: "The city of the address."
                        }
                        line1: {
                          type: "string"
                          description: "The first line of the address. This is usually the street number and street."
                        }
                        line2: {
                          type: "string"
                          description: "The second line of the address. This might be the floor or room number."
                        }
                        state: {
                          type: "string"
                          description: "The two-letter United States Postal Service (USPS) abbreviation for the state of the address."
                        }
                        zip: {
                          type: "string"
                          description: "The ZIP code of the address."
                        }
                      }
                    }
                    confirmed_no_us_tax_id: {
                      type: "boolean"
                      description: "The identification method for an individual can only be a passport, driver's license, or other document if you've confirmed the individual does not have a US tax id (either a Social Security Number or Individual Taxpayer Identification Number)."
                    }
                    date_of_birth: {
                      type: "string"
                      format: "date"
                      description: "The person's date of birth in YYYY-MM-DD format."
                    }
                    identification: {
                      type: "object"
                      description: "A means of verifying the person's identity."
                      required: ["method", "number"]
                      properties: {
                        drivers_license: {
                          type: "object"
                          description: "Information about the United States driver's license used for identification. Required if `method` is equal to `drivers_license`."
                          required: ["file_id", "expiration_date", "state"]
                          properties: {
                            expiration_date: {
                              type: "string"
                              format: "date"
                              description: "The driver's license's expiration date in YYYY-MM-DD format."
                            }
                            file_id: {
                              type: "string"
                              description: "The identifier of the File containing the driver's license."
                            }
                            state: {
                              type: "string"
                              description: "The state that issued the provided driver's license."
                            }
                          }
                        }
                        method: {
                          type: "string"
                          description: "A method that can be used to verify the individual's identity."
                          enum: ["social_security_number", "individual_taxpayer_identification_number", "passport", "drivers_license", "other"]
                        }
                        number: {
                          type: "string"
                          description: "An identification number that can be used to verify the individual's identity, such as a social security number."
                        }
                        other: {
                          type: "object"
                          description: "Information about the identification document provided. Required if `method` is equal to `other`."
                          required: ["country", "description", "file_id"]
                          properties: {
                            country: {
                              type: "string"
                              description: "The two-character ISO 3166-1 code representing the country that issued the document."
                            }
                            description: {
                              type: "string"
                              description: "A description of the document submitted."
                            }
                            expiration_date: {
                              type: "string"
                              format: "date"
                              description: "The document's expiration date in YYYY-MM-DD format."
                            }
                            file_id: {
                              type: "string"
                              description: "The identifier of the File containing the document."
                            }
                          }
                        }
                        passport: {
                          type: "object"
                          description: "Information about the passport used for identification. Required if `method` is equal to `passport`."
                          required: ["file_id", "expiration_date", "country"]
                          properties: {
                            country: {
                              type: "string"
                              description: "The country that issued the passport."
                            }
                            expiration_date: {
                              type: "string"
                              format: "date"
                              description: "The passport's expiration date in YYYY-MM-DD format."
                            }
                            file_id: {
                              type: "string"
                              description: "The identifier of the File containing the passport."
                            }
                          }
                        }
                      }
                    }
                    name: {
                      type: "string"
                      description: "The person's legal name."
                    }
                  }
                }
                structure: {
                  type: "string"
                  description: "The structure of the trustee."
                  enum: ["individual"]
                }
              }
            }
          }
        }
      }
    }
  }
  output: {
    type: "object"
    description: "Entities are the legal entities that own accounts. They can be people, corporations, partnerships, or trusts."
    required: ["corporation", "description", "id", "joint", "natural_person", "relationship", "structure", "supplemental_documents", "trust", "type"]
    properties: {
      corporation: {
        type: "object"
        description: "Details of the corporation entity. Will be present if `structure` is equal to `corporation`."
        required: ["address", "beneficial_owners", "incorporation_state", "name", "tax_identifier", "website"]
        properties: {
          address: {
            type: "object"
            description: "The corporation's address."
            required: ["city", "line1", "line2", "state", "zip"]
            properties: {
              city: {
                type: "string"
                description: "The city of the address."
              }
              line1: {
                type: "string"
                description: "The first line of the address."
              }
              line2: {
                type: "string"
                description: "The second line of the address."
              }
              state: {
                type: "string"
                description: "The two-letter United States Postal Service (USPS) abbreviation for the state of the address."
              }
              zip: {
                type: "string"
                description: "The ZIP code of the address."
              }
            }
          }
          beneficial_owners: {
            type: "array"
            description: "The identifying details of anyone controlling or owning 25% or more of the corporation."
            items: {
              type: "object"
              required: ["individual", "company_title", "prong"]
              properties: {
                company_title: {
                  type: "string"
                  description: "This person's role or title within the entity."
                }
                individual: {
                  type: "object"
                  description: "Personal details for the beneficial owner."
                  required: ["name", "date_of_birth", "address", "identification"]
                  properties: {
                    address: {
                      type: "object"
                      description: "The person's address."
                      required: ["line1", "line2", "city", "state", "zip"]
                      properties: {
                        city: {
                          type: "string"
                          description: "The city of the address."
                        }
                        line1: {
                          type: "string"
                          description: "The first line of the address."
                        }
                        line2: {
                          type: "string"
                          description: "The second line of the address."
                        }
                        state: {
                          type: "string"
                          description: "The two-letter United States Postal Service (USPS) abbreviation for the state of the address."
                        }
                        zip: {
                          type: "string"
                          description: "The ZIP code of the address."
                        }
                      }
                    }
                    date_of_birth: {
                      type: "string"
                      format: "date"
                      description: "The person's date of birth in YYYY-MM-DD format."
                    }
                    identification: {
                      type: "object"
                      description: "A means of verifying the person's identity."
                      required: ["method", "number_last4"]
                      properties: {
                        method: {
                          type: "string"
                          description: "A method that can be used to verify the individual's identity."
                          enum: ["social_security_number", "individual_taxpayer_identification_number", "passport", "drivers_license", "other"]
                        }
                        number_last4: {
                          type: "string"
                          description: "The last 4 digits of the identification number that can be used to verify the individual's identity."
                        }
                      }
                    }
                    name: {
                      type: "string"
                      description: "The person's legal name."
                    }
                  }
                }
                prong: {
                  type: "string"
                  description: "Why this person is considered a beneficial owner of the entity."
                  enum: ["ownership", "control"]
                }
              }
            }
          }
          incorporation_state: {
            type: "string"
            description: "The two-letter United States Postal Service (USPS) abbreviation for the corporation's state of incorporation."
          }
          name: {
            type: "string"
            description: "The legal name of the corporation."
          }
          tax_identifier: {
            type: "string"
            description: "The Employer Identification Number (EIN) for the corporation."
          }
          website: {
            type: "string"
            description: "The website of the corporation."
          }
        }
      }
      description: {
        type: "string"
        description: "The entity's description for display purposes."
      }
      id: {
        type: "string"
        description: "The entity's identifier."
      }
      joint: {
        type: "object"
        description: "Details of the joint entity. Will be present if `structure` is equal to `joint`."
        required: ["individuals", "name"]
        properties: {
          individuals: {
            type: "array"
            description: "The two individuals that share control of the entity."
            items: {
              type: "object"
              required: ["name", "date_of_birth", "address", "identification"]
              properties: {
                address: {
                  type: "object"
                  description: "The person's address."
                  required: ["line1", "line2", "city", "state", "zip"]
                  properties: {
                    city: {
                      type: "string"
                      description: "The city of the address."
                    }
                    line1: {
                      type: "string"
                      description: "The first line of the address."
                    }
                    line2: {
                      type: "string"
                      description: "The second line of the address."
                    }
                    state: {
                      type: "string"
                      description: "The two-letter United States Postal Service (USPS) abbreviation for the state of the address."
                    }
                    zip: {
                      type: "string"
                      description: "The ZIP code of the address."
                    }
                  }
                }
                date_of_birth: {
                  type: "string"
                  format: "date"
                  description: "The person's date of birth in YYYY-MM-DD format."
                }
                identification: {
                  type: "object"
                  description: "A means of verifying the person's identity."
                  required: ["method", "number_last4"]
                  properties: {
                    method: {
                      type: "string"
                      description: "A method that can be used to verify the individual's identity."
                      enum: ["social_security_number", "individual_taxpayer_identification_number", "passport", "drivers_license", "other"]
                    }
                    number_last4: {
                      type: "string"
                      description: "The last 4 digits of the identification number that can be used to verify the individual's identity."
                    }
                  }
                }
                name: {
                  type: "string"
                  description: "The person's legal name."
                }
              }
            }
          }
          name: {
            type: "string"
            description: "The entity's name."
          }
        }
      }
      natural_person: {
        type: "object"
        description: "Details of the natural person entity. Will be present if `structure` is equal to `natural_person`."
        required: ["address", "date_of_birth", "identification", "name"]
        properties: {
          address: {
            type: "object"
            description: "The person's address."
            required: ["city", "line1", "line2", "state", "zip"]
            properties: {
              city: {
                type: "string"
                description: "The city of the address."
              }
              line1: {
                type: "string"
                description: "The first line of the address."
              }
              line2: {
                type: "string"
                description: "The second line of the address."
              }
              state: {
                type: "string"
                description: "The two-letter United States Postal Service (USPS) abbreviation for the state of the address."
              }
              zip: {
                type: "string"
                description: "The ZIP code of the address."
              }
            }
          }
          date_of_birth: {
            type: "string"
            format: "date"
            description: "The person's date of birth in YYYY-MM-DD format."
          }
          identification: {
            type: "object"
            description: "A means of verifying the person's identity."
            required: ["method", "number_last4"]
            properties: {
              method: {
                type: "string"
                description: "A method that can be used to verify the individual's identity."
                enum: ["social_security_number", "individual_taxpayer_identification_number", "passport", "drivers_license", "other"]
              }
              number_last4: {
                type: "string"
                description: "The last 4 digits of the identification number that can be used to verify the individual's identity."
              }
            }
          }
          name: {
            type: "string"
            description: "The person's legal name."
          }
        }
      }
      relationship: {
        type: "string"
        description: "The relationship between your group and the entity."
        enum: ["affiliated", "informational", "unaffiliated"]
      }
      structure: {
        type: "string"
        description: "The entity's legal structure."
        enum: ["corporation", "natural_person", "joint", "trust"]
      }
      supplemental_documents: {
        type: "array"
        description: "Additional documentation associated with the entity."
        items: {
          type: "object"
          required: ["file_id"]
          properties: {
            file_id: {
              type: "string"
              description: "The File containing the document."
            }
          }
        }
      }
      trust: {
        type: "object"
        description: "Details of the trust entity. Will be present if `structure` is equal to `trust`."
        required: ["address", "category", "formation_document_file_id", "formation_state", "grantor", "name", "tax_identifier", "trustees"]
        properties: {
          address: {
            type: "object"
            description: "The trust's address."
            required: ["city", "line1", "line2", "state", "zip"]
            properties: {
              city: {
                type: "string"
                description: "The city of the address."
              }
              line1: {
                type: "string"
                description: "The first line of the address."
              }
              line2: {
                type: "string"
                description: "The second line of the address."
              }
              state: {
                type: "string"
                description: "The two-letter United States Postal Service (USPS) abbreviation for the state of the address."
              }
              zip: {
                type: "string"
                description: "The ZIP code of the address."
              }
            }
          }
          category: {
            type: "string"
            description: "Whether the trust is `revocable` or `irrevocable`."
            enum: ["revocable", "irrevocable"]
          }
          formation_document_file_id: {
            type: "string"
            description: "The ID for the File containing the formation document of the trust."
          }
          formation_state: {
            type: "string"
            description: "The two-letter United States Postal Service (USPS) abbreviation for the state in which the trust was formed."
          }
          grantor: {
            type: "object"
            description: "The grantor of the trust. Will be present if the `category` is `revocable`."
            required: ["address", "date_of_birth", "identification", "name"]
            properties: {
              address: {
                type: "object"
                description: "The person's address."
                required: ["city", "line1", "line2", "state", "zip"]
                properties: {
                  city: {
                    type: "string"
                    description: "The city of the address."
                  }
                  line1: {
                    type: "string"
                    description: "The first line of the address."
                  }
                  line2: {
                    type: "string"
                    description: "The second line of the address."
                  }
                  state: {
                    type: "string"
                    description: "The two-letter United States Postal Service (USPS) abbreviation for the state of the address."
                  }
                  zip: {
                    type: "string"
                    description: "The ZIP code of the address."
                  }
                }
              }
              date_of_birth: {
                type: "string"
                format: "date"
                description: "The person's date of birth in YYYY-MM-DD format."
              }
              identification: {
                type: "object"
                description: "A means of verifying the person's identity."
                required: ["method", "number_last4"]
                properties: {
                  method: {
                    type: "string"
                    description: "A method that can be used to verify the individual's identity."
                    enum: ["social_security_number", "individual_taxpayer_identification_number", "passport", "drivers_license", "other"]
                  }
                  number_last4: {
                    type: "string"
                    description: "The last 4 digits of the identification number that can be used to verify the individual's identity."
                  }
                }
              }
              name: {
                type: "string"
                description: "The person's legal name."
              }
            }
          }
          name: {
            type: "string"
            description: "The trust's name"
          }
          tax_identifier: {
            type: "string"
            description: "The Employer Identification Number (EIN) of the trust itself."
          }
          trustees: {
            type: "array"
            description: "The trustees of the trust."
            items: {
              type: "object"
              required: ["structure", "individual"]
              properties: {
                individual: {
                  type: "object"
                  description: "The individual trustee of the trust. Will be present if the trustee's `structure` is equal to `individual`."
                  required: ["name", "date_of_birth", "address", "identification"]
                  properties: {
                    address: {
                      type: "object"
                      description: "The person's address."
                      required: ["line1", "line2", "city", "state", "zip"]
                      properties: {
                        city: {
                          type: "string"
                          description: "The city of the address."
                        }
                        line1: {
                          type: "string"
                          description: "The first line of the address."
                        }
                        line2: {
                          type: "string"
                          description: "The second line of the address."
                        }
                        state: {
                          type: "string"
                          description: "The two-letter United States Postal Service (USPS) abbreviation for the state of the address."
                        }
                        zip: {
                          type: "string"
                          description: "The ZIP code of the address."
                        }
                      }
                    }
                    date_of_birth: {
                      type: "string"
                      format: "date"
                      description: "The person's date of birth in YYYY-MM-DD format."
                    }
                    identification: {
                      type: "object"
                      description: "A means of verifying the person's identity."
                      required: ["method", "number_last4"]
                      properties: {
                        method: {
                          type: "string"
                          description: "A method that can be used to verify the individual's identity."
                          enum: ["social_security_number", "individual_taxpayer_identification_number", "passport", "drivers_license", "other"]
                        }
                        number_last4: {
                          type: "string"
                          description: "The last 4 digits of the identification number that can be used to verify the individual's identity."
                        }
                      }
                    }
                    name: {
                      type: "string"
                      description: "The person's legal name."
                    }
                  }
                }
                structure: {
                  type: "string"
                  description: "The structure of the trustee. Will always be equal to `individual`."
                  enum: ["individual"]
                }
              }
            }
          }
        }
      }
      type: {
        type: "string"
        description: "A constant representing the object's type. For this resource it will always be `entity`."
        enum: ["entity"]
      }
    }
  }
}