> ## Documentation Index
> Fetch the complete documentation index at: https://docs.engine.usesophic.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a person

> Creates a person from claims with optional verification evidence. Supports both natural and legal persons.



## OpenAPI

````yaml https://api.engine.usesophic.com/openapi.json post /persons
openapi: 3.1.0
info:
  title: Sophic Engine API
  version: 0.1.0
servers:
  - url: https://api.engine.usesophic.com/
security: []
paths:
  /persons:
    post:
      summary: Create a person
      description: >-
        Creates a person from claims with optional verification evidence.
        Supports both natural and legal persons.
      operationId: create_person_persons_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatePersonRequest'
        required: true
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PersonCreationResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - HTTPBearer: []
components:
  schemas:
    CreatePersonRequest:
      properties:
        person_type:
          allOf:
            - $ref: '#/components/schemas/PersonType'
          description: 'The type of person to create: natural or legal.'
        claims:
          items:
            anyOf:
              - $ref: '#/components/schemas/IdentityClaimSpec'
              - $ref: '#/components/schemas/NationalitiesClaimSpec'
              - $ref: '#/components/schemas/ResidenceClaimSpec'
              - $ref: '#/components/schemas/TaxResidenciesClaimSpec'
              - $ref: '#/components/schemas/FatcaStatusClaimSpec'
              - $ref: '#/components/schemas/PepStatusClaimSpec'
              - $ref: '#/components/schemas/EducationLevelClaimSpec'
              - $ref: '#/components/schemas/EmploymentClaimSpec'
              - $ref: '#/components/schemas/FinancialProfileClaimSpec'
              - $ref: '#/components/schemas/InvestmentExperienceClaimSpec'
              - $ref: '#/components/schemas/RegistrationClaimSpec'
              - $ref: '#/components/schemas/ContactDetailsClaimSpec'
              - $ref: '#/components/schemas/LeiClaimSpec'
              - $ref: '#/components/schemas/RegisteredAddressClaimSpec'
              - $ref: '#/components/schemas/OperatingAddressClaimSpec'
              - $ref: '#/components/schemas/BusinessNatureClaimSpec'
              - $ref: '#/components/schemas/ExpectedActivityClaimSpec'
              - $ref: '#/components/schemas/RelationshipsClaimSpec'
          type: array
          minItems: 1
          title: Claims
          description: Typed claim specs for the person.
      type: object
      required:
        - person_type
        - claims
      title: CreatePersonRequest
      description: Create a person with claims.
    PersonCreationResponse:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        person_type:
          allOf:
            - $ref: '#/components/schemas/PersonType'
          description: The type of person (natural or legal).
        full_name:
          type: string
          title: Full Name
          description: The full name of the person.
        claims:
          items:
            oneOf:
              - $ref: '#/components/schemas/IdentityPersonClaimSummary'
              - $ref: '#/components/schemas/NationalitiesPersonClaimSummary'
              - $ref: '#/components/schemas/ResidencePersonClaimSummary'
              - $ref: '#/components/schemas/TaxResidenciesPersonClaimSummary'
              - $ref: '#/components/schemas/FatcaStatusPersonClaimSummary'
              - $ref: '#/components/schemas/PepStatusPersonClaimSummary'
              - $ref: '#/components/schemas/EducationLevelPersonClaimSummary'
              - $ref: '#/components/schemas/EmploymentPersonClaimSummary'
              - $ref: '#/components/schemas/FinancialProfilePersonClaimSummary'
              - $ref: '#/components/schemas/InvestmentExperiencePersonClaimSummary'
              - $ref: '#/components/schemas/RegistrationPersonClaimSummary'
              - $ref: '#/components/schemas/ContactDetailsPersonClaimSummary'
              - $ref: '#/components/schemas/LeiPersonClaimSummary'
              - $ref: '#/components/schemas/RegisteredAddressPersonClaimSummary'
              - $ref: '#/components/schemas/OperatingAddressPersonClaimSummary'
              - $ref: '#/components/schemas/BusinessNaturePersonClaimSummary'
              - $ref: '#/components/schemas/ExpectedActivityPersonClaimSummary'
              - $ref: '#/components/schemas/RelationshipsPersonClaimSummary'
            discriminator:
              propertyName: claim_type
              mapping:
                business_nature:
                  $ref: '#/components/schemas/BusinessNaturePersonClaimSummary'
                contact_details:
                  $ref: '#/components/schemas/ContactDetailsPersonClaimSummary'
                education_level:
                  $ref: '#/components/schemas/EducationLevelPersonClaimSummary'
                employment:
                  $ref: '#/components/schemas/EmploymentPersonClaimSummary'
                expected_activity:
                  $ref: '#/components/schemas/ExpectedActivityPersonClaimSummary'
                fatca_status:
                  $ref: '#/components/schemas/FatcaStatusPersonClaimSummary'
                financial_profile:
                  $ref: '#/components/schemas/FinancialProfilePersonClaimSummary'
                identity:
                  $ref: '#/components/schemas/IdentityPersonClaimSummary'
                investment_experience:
                  $ref: '#/components/schemas/InvestmentExperiencePersonClaimSummary'
                lei:
                  $ref: '#/components/schemas/LeiPersonClaimSummary'
                nationalities:
                  $ref: '#/components/schemas/NationalitiesPersonClaimSummary'
                operating_address:
                  $ref: '#/components/schemas/OperatingAddressPersonClaimSummary'
                pep_status:
                  $ref: '#/components/schemas/PepStatusPersonClaimSummary'
                registered_address:
                  $ref: '#/components/schemas/RegisteredAddressPersonClaimSummary'
                registration:
                  $ref: '#/components/schemas/RegistrationPersonClaimSummary'
                relationships:
                  $ref: '#/components/schemas/RelationshipsPersonClaimSummary'
                residence:
                  $ref: '#/components/schemas/ResidencePersonClaimSummary'
                tax_residencies:
                  $ref: '#/components/schemas/TaxResidenciesPersonClaimSummary'
          type: array
          title: Claims
          description: Claims created for this person.
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            The timestamp (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format) of when the resource was created.
        modified_at:
          type: string
          format: date-time
          title: Modified At
          description: >-
            The timestamp (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format) of when the resource was last modified.
      type: object
      required:
        - created_at
        - modified_at
        - id
        - person_type
        - full_name
        - claims
      title: PersonCreationResponse
      description: |-
        Response for a person created from claims.

        Includes the person summary and all created claims.
    Error:
      properties:
        detail:
          type: string
          title: Detail
          description: A human-readable description of the error.
        code:
          type: string
          title: Code
          description: A machine-readable error code.
        docs:
          title: Docs
          description: A URL to documentation about this error code.
          x-remove-null-from-type-union: true
          type: string
        context:
          title: Context
          description: An optional object for adding extra context to the error.
          x-remove-null-from-type-union: true
          additionalProperties:
            anyOf:
              - type: string
              - type: integer
          type: object
        params:
          title: Params
          description: An optional list of params that failed validation.
          x-remove-null-from-type-union: true
          items:
            $ref: '#/components/schemas/InvalidParam'
          type: array
      type: object
      required:
        - detail
        - code
      title: Error
    PersonType:
      type: string
      enum:
        - natural
        - legal
      title: PersonType
      properties: {}
    IdentityClaimSpec:
      properties:
        claim_type:
          const: identity
          title: Claim Type
        first_name:
          type: string
          title: First Name
        last_name:
          type: string
          title: Last Name
        date_of_birth:
          type: string
          format: date
          title: Date Of Birth
      additionalProperties: false
      type: object
      required:
        - claim_type
        - first_name
        - last_name
        - date_of_birth
      title: IdentityClaimSpec
      description: Spec for identity claim data.
    NationalitiesClaimSpec:
      properties:
        claim_type:
          const: nationalities
          title: Claim Type
        nationalities:
          items:
            $ref: '#/components/schemas/NationalityEntry'
          type: array
          title: Nationalities
      additionalProperties: false
      type: object
      required:
        - claim_type
      title: NationalitiesClaimSpec
      description: Spec for nationalities claim data.
    ResidenceClaimSpec:
      properties:
        line1:
          type: string
          title: Line1
        line2:
          anyOf:
            - type: string
            - type: 'null'
          title: Line2
        line3:
          anyOf:
            - type: string
            - type: 'null'
          title: Line3
        district_county:
          anyOf:
            - type: string
            - type: 'null'
          title: District County
        postal_code:
          type: string
          title: Postal Code
        city:
          type: string
          title: City
        country_code:
          type: string
          title: Country Code
        claim_type:
          const: residence
          title: Claim Type
      additionalProperties: false
      type: object
      required:
        - line1
        - postal_code
        - city
        - country_code
        - claim_type
      title: ResidenceClaimSpec
      description: Spec for residence claim data (aligned with Address).
    TaxResidenciesClaimSpec:
      properties:
        claim_type:
          const: tax_residencies
          title: Claim Type
        tax_residencies:
          items:
            $ref: '#/components/schemas/TaxResidencyEntry'
          type: array
          title: Tax Residencies
      additionalProperties: false
      type: object
      required:
        - claim_type
      title: TaxResidenciesClaimSpec
      description: Spec for tax residencies claim data.
    FatcaStatusClaimSpec:
      properties:
        claim_type:
          const: fatca_status
          title: Claim Type
        is_us_person:
          type: boolean
          title: Is Us Person
      additionalProperties: false
      type: object
      required:
        - claim_type
        - is_us_person
      title: FatcaStatusClaimSpec
      description: Spec for FATCA US-person status (natural or legal person).
    PepStatusClaimSpec:
      properties:
        claim_type:
          const: pep_status
          title: Claim Type
        is_pep:
          type: boolean
          title: Is Pep
        pep_role:
          anyOf:
            - type: string
            - type: 'null'
          title: Pep Role
        pep_role_start_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Pep Role Start Date
        pep_role_end_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Pep Role End Date
        has_pep_association:
          type: boolean
          title: Has Pep Association
        pep_associate_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Pep Associate Name
        pep_associate_relationship:
          anyOf:
            - type: string
            - type: 'null'
          title: Pep Associate Relationship
      additionalProperties: false
      type: object
      required:
        - claim_type
        - is_pep
        - has_pep_association
      title: PepStatusClaimSpec
      description: Spec for politically exposed person (PEP) declaration claim data.
    EducationLevelClaimSpec:
      properties:
        claim_type:
          const: education_level
          title: Claim Type
        education_level:
          $ref: '#/components/schemas/ClaimEducationLevel'
      additionalProperties: false
      type: object
      required:
        - claim_type
        - education_level
      title: EducationLevelClaimSpec
      description: Spec for education level claim data (MiFID II suitability).
    EmploymentClaimSpec:
      properties:
        claim_type:
          const: employment
          title: Claim Type
        employment_status:
          $ref: '#/components/schemas/ClaimEmploymentStatus'
        industry:
          anyOf:
            - $ref: '#/components/schemas/ClaimIndustry'
            - type: 'null'
        industry_other:
          anyOf:
            - type: string
            - type: 'null'
          title: Industry Other
      additionalProperties: false
      type: object
      required:
        - claim_type
        - employment_status
      title: EmploymentClaimSpec
      description: Spec for employment claim data (MiFID II suitability).
    FinancialProfileClaimSpec:
      properties:
        claim_type:
          const: financial_profile
          title: Claim Type
        annual_income_eur:
          $ref: '#/components/schemas/EurAmountBand'
        income_sources:
          items:
            $ref: '#/components/schemas/ClaimIncomeSource'
          type: array
          minItems: 1
          title: Income Sources
        net_worth_eur:
          $ref: '#/components/schemas/EurAmountBand'
        wealth_sources:
          items:
            $ref: '#/components/schemas/ClaimWealthSource'
          type: array
          minItems: 1
          title: Wealth Sources
      additionalProperties: false
      type: object
      required:
        - claim_type
        - annual_income_eur
        - income_sources
        - net_worth_eur
        - wealth_sources
      title: FinancialProfileClaimSpec
      description: Spec for income and wealth financial profile claim data.
    InvestmentExperienceClaimSpec:
      properties:
        claim_type:
          const: investment_experience
          title: Claim Type
        has_prior_experience:
          type: boolean
          title: Has Prior Experience
        asset_classes:
          items:
            $ref: '#/components/schemas/ClaimAssetClass'
          type: array
          title: Asset Classes
      additionalProperties: false
      type: object
      required:
        - claim_type
        - has_prior_experience
      title: InvestmentExperienceClaimSpec
      description: Spec for prior investment experience claim data.
    RegistrationClaimSpec:
      properties:
        claim_type:
          const: registration
          title: Claim Type
        legal_name:
          type: string
          title: Legal Name
        trading_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Trading Name
        registration_number:
          type: string
          title: Registration Number
        date_of_incorporation:
          type: string
          format: date
          title: Date Of Incorporation
        country_of_incorporation:
          type: string
          title: Country Of Incorporation
        entity_type:
          $ref: '#/components/schemas/ClaimRegistrationEntityType'
      additionalProperties: false
      type: object
      required:
        - claim_type
        - legal_name
        - registration_number
        - date_of_incorporation
        - country_of_incorporation
        - entity_type
      title: RegistrationClaimSpec
      description: Spec for legal entity registration claim data.
    ContactDetailsClaimSpec:
      properties:
        claim_type:
          const: contact_details
          title: Claim Type
        phone_number:
          type: string
          title: Phone Number
        email:
          anyOf:
            - type: string
            - type: 'null'
          title: Email
      additionalProperties: false
      type: object
      required:
        - claim_type
        - phone_number
      title: ContactDetailsClaimSpec
      description: Spec for legal entity contact details claim data.
    LeiClaimSpec:
      properties:
        claim_type:
          const: lei
          title: Claim Type
        identifier:
          type: string
          title: Identifier
        expiry_date:
          type: string
          format: date
          title: Expiry Date
      additionalProperties: false
      type: object
      required:
        - claim_type
        - identifier
        - expiry_date
      title: LeiClaimSpec
      description: Spec for Legal Entity Identifier (LEI) claim data.
    RegisteredAddressClaimSpec:
      properties:
        line1:
          type: string
          title: Line1
        line2:
          anyOf:
            - type: string
            - type: 'null'
          title: Line2
        line3:
          anyOf:
            - type: string
            - type: 'null'
          title: Line3
        district_county:
          anyOf:
            - type: string
            - type: 'null'
          title: District County
        postal_code:
          type: string
          title: Postal Code
        city:
          type: string
          title: City
        country_code:
          type: string
          title: Country Code
        claim_type:
          const: registered_address
          title: Claim Type
        operating_address_is_same:
          type: boolean
          title: Operating Address Is Same
          default: false
      additionalProperties: false
      type: object
      required:
        - line1
        - postal_code
        - city
        - country_code
        - claim_type
      title: RegisteredAddressClaimSpec
      description: |-
        Spec for legal entity registered address claim data.

        When `operating_address_is_same` is True, onboarding applications for
        this entity do not need a separate `operating_address` claim or
        `proof_of_operating_address` evidence -- compliance treats the
        registered address as both. Defaults to False so existing behaviour
        (distinct operating address required) is preserved.
    OperatingAddressClaimSpec:
      properties:
        line1:
          type: string
          title: Line1
        line2:
          anyOf:
            - type: string
            - type: 'null'
          title: Line2
        line3:
          anyOf:
            - type: string
            - type: 'null'
          title: Line3
        district_county:
          anyOf:
            - type: string
            - type: 'null'
          title: District County
        postal_code:
          type: string
          title: Postal Code
        city:
          type: string
          title: City
        country_code:
          type: string
          title: Country Code
        claim_type:
          const: operating_address
          title: Claim Type
      additionalProperties: false
      type: object
      required:
        - line1
        - postal_code
        - city
        - country_code
        - claim_type
      title: OperatingAddressClaimSpec
      description: Spec for legal entity operating (principal place of business) address.
    BusinessNatureClaimSpec:
      properties:
        claim_type:
          const: business_nature
          title: Claim Type
        business_activity:
          $ref: '#/components/schemas/ClaimIndustry'
        business_activity_other:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Activity Other
        annual_turnover_eur:
          $ref: '#/components/schemas/EurAmountBand'
        is_regulated:
          type: boolean
          title: Is Regulated
        license_number:
          anyOf:
            - type: string
            - type: 'null'
          title: License Number
        issues_bearer_shares:
          type: boolean
          title: Issues Bearer Shares
        has_nominee_shareholders:
          type: boolean
          title: Has Nominee Shareholders
        has_shell_bank_relationships:
          type: boolean
          title: Has Shell Bank Relationships
      additionalProperties: false
      type: object
      required:
        - claim_type
        - business_activity
        - annual_turnover_eur
        - is_regulated
        - issues_bearer_shares
        - has_nominee_shareholders
        - has_shell_bank_relationships
      title: BusinessNatureClaimSpec
      description: Spec for legal entity business nature and turnover claim data.
    ExpectedActivityClaimSpec:
      properties:
        claim_type:
          const: expected_activity
          title: Claim Type
        funding_currency:
          type: string
          title: Funding Currency
        asset_classes:
          items:
            type: string
          type: array
          title: Asset Classes
        annual_transactions:
          type: string
          title: Annual Transactions
        investment_amount:
          type: string
          title: Investment Amount
      additionalProperties: false
      type: object
      required:
        - claim_type
        - funding_currency
        - asset_classes
        - annual_transactions
        - investment_amount
      title: ExpectedActivityClaimSpec
      description: Spec for expected investment activity claim data.
    RelationshipsClaimSpec:
      properties:
        claim_type:
          const: relationships
          title: Claim Type
        relationships:
          items:
            $ref: '#/components/schemas/RelationshipEntry-Input'
          type: array
          minItems: 1
          title: Relationships
      additionalProperties: false
      type: object
      required:
        - claim_type
        - relationships
      title: RelationshipsClaimSpec
      description: Spec for person relationships (UBOs, directors, shareholders, etc.).
    IdentityPersonClaimSummary:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        claim_type:
          const: identity
          title: Claim Type
        first_name:
          type: string
          title: First Name
        last_name:
          type: string
          title: Last Name
        date_of_birth:
          type: string
          format: date
          title: Date Of Birth
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: The status of the claim (`pending` or `verified`).
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            The timestamp (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format) of when the claim was created.
      additionalProperties: false
      type: object
      required:
        - claim_type
        - first_name
        - last_name
        - date_of_birth
        - id
        - created_at
        - status
      title: IdentityPersonClaimSummary
      description: Identity claim summary.
    NationalitiesPersonClaimSummary:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        claim_type:
          const: nationalities
          title: Claim Type
        nationalities:
          items:
            $ref: '#/components/schemas/NationalityEntry'
          type: array
          title: Nationalities
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: The status of the claim (`pending` or `verified`).
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            The timestamp (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format) of when the claim was created.
      additionalProperties: false
      type: object
      required:
        - claim_type
        - id
        - created_at
        - status
      title: NationalitiesPersonClaimSummary
      description: Nationalities claim summary.
    ResidencePersonClaimSummary:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        line1:
          type: string
          title: Line1
        line2:
          anyOf:
            - type: string
            - type: 'null'
          title: Line2
        line3:
          anyOf:
            - type: string
            - type: 'null'
          title: Line3
        district_county:
          anyOf:
            - type: string
            - type: 'null'
          title: District County
        postal_code:
          type: string
          title: Postal Code
        city:
          type: string
          title: City
        country_code:
          type: string
          title: Country Code
        claim_type:
          const: residence
          title: Claim Type
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: The status of the claim (`pending` or `verified`).
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            The timestamp (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format) of when the claim was created.
      additionalProperties: false
      type: object
      required:
        - line1
        - postal_code
        - city
        - country_code
        - claim_type
        - id
        - created_at
        - status
      title: ResidencePersonClaimSummary
      description: Residence claim summary.
    TaxResidenciesPersonClaimSummary:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        claim_type:
          const: tax_residencies
          title: Claim Type
        tax_residencies:
          items:
            $ref: '#/components/schemas/TaxResidencyEntry'
          type: array
          title: Tax Residencies
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: The status of the claim (`pending` or `verified`).
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            The timestamp (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format) of when the claim was created.
      additionalProperties: false
      type: object
      required:
        - claim_type
        - id
        - created_at
        - status
      title: TaxResidenciesPersonClaimSummary
      description: Tax residencies claim summary.
    FatcaStatusPersonClaimSummary:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        claim_type:
          const: fatca_status
          title: Claim Type
        is_us_person:
          type: boolean
          title: Is Us Person
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: The status of the claim (`pending` or `verified`).
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            The timestamp (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format) of when the claim was created.
      additionalProperties: false
      type: object
      required:
        - claim_type
        - is_us_person
        - id
        - created_at
        - status
      title: FatcaStatusPersonClaimSummary
      description: FATCA status claim summary.
    PepStatusPersonClaimSummary:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        claim_type:
          const: pep_status
          title: Claim Type
        is_pep:
          type: boolean
          title: Is Pep
        pep_role:
          anyOf:
            - type: string
            - type: 'null'
          title: Pep Role
        pep_role_start_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Pep Role Start Date
        pep_role_end_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Pep Role End Date
        has_pep_association:
          type: boolean
          title: Has Pep Association
        pep_associate_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Pep Associate Name
        pep_associate_relationship:
          anyOf:
            - type: string
            - type: 'null'
          title: Pep Associate Relationship
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: The status of the claim (`pending` or `verified`).
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            The timestamp (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format) of when the claim was created.
      additionalProperties: false
      type: object
      required:
        - claim_type
        - is_pep
        - has_pep_association
        - id
        - created_at
        - status
      title: PepStatusPersonClaimSummary
      description: PEP status claim summary.
    EducationLevelPersonClaimSummary:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        claim_type:
          const: education_level
          title: Claim Type
        education_level:
          $ref: '#/components/schemas/ClaimEducationLevel'
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: The status of the claim (`pending` or `verified`).
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            The timestamp (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format) of when the claim was created.
      additionalProperties: false
      type: object
      required:
        - claim_type
        - education_level
        - id
        - created_at
        - status
      title: EducationLevelPersonClaimSummary
      description: Education level claim summary.
    EmploymentPersonClaimSummary:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        claim_type:
          const: employment
          title: Claim Type
        employment_status:
          $ref: '#/components/schemas/ClaimEmploymentStatus'
        industry:
          anyOf:
            - $ref: '#/components/schemas/ClaimIndustry'
            - type: 'null'
        industry_other:
          anyOf:
            - type: string
            - type: 'null'
          title: Industry Other
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: The status of the claim (`pending` or `verified`).
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            The timestamp (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format) of when the claim was created.
      additionalProperties: false
      type: object
      required:
        - claim_type
        - employment_status
        - id
        - created_at
        - status
      title: EmploymentPersonClaimSummary
      description: Employment claim summary.
    FinancialProfilePersonClaimSummary:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        claim_type:
          const: financial_profile
          title: Claim Type
        annual_income_eur:
          $ref: '#/components/schemas/EurAmountBand'
        income_sources:
          items:
            $ref: '#/components/schemas/ClaimIncomeSource'
          type: array
          minItems: 1
          title: Income Sources
        net_worth_eur:
          $ref: '#/components/schemas/EurAmountBand'
        wealth_sources:
          items:
            $ref: '#/components/schemas/ClaimWealthSource'
          type: array
          minItems: 1
          title: Wealth Sources
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: The status of the claim (`pending` or `verified`).
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            The timestamp (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format) of when the claim was created.
      additionalProperties: false
      type: object
      required:
        - claim_type
        - annual_income_eur
        - income_sources
        - net_worth_eur
        - wealth_sources
        - id
        - created_at
        - status
      title: FinancialProfilePersonClaimSummary
      description: Financial profile claim summary.
    InvestmentExperiencePersonClaimSummary:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        claim_type:
          const: investment_experience
          title: Claim Type
        has_prior_experience:
          type: boolean
          title: Has Prior Experience
        asset_classes:
          items:
            $ref: '#/components/schemas/ClaimAssetClass'
          type: array
          title: Asset Classes
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: The status of the claim (`pending` or `verified`).
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            The timestamp (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format) of when the claim was created.
      additionalProperties: false
      type: object
      required:
        - claim_type
        - has_prior_experience
        - id
        - created_at
        - status
      title: InvestmentExperiencePersonClaimSummary
      description: Investment experience claim summary.
    RegistrationPersonClaimSummary:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        claim_type:
          const: registration
          title: Claim Type
        legal_name:
          type: string
          title: Legal Name
        trading_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Trading Name
        registration_number:
          type: string
          title: Registration Number
        date_of_incorporation:
          type: string
          format: date
          title: Date Of Incorporation
        country_of_incorporation:
          type: string
          title: Country Of Incorporation
        entity_type:
          $ref: '#/components/schemas/ClaimRegistrationEntityType'
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: The status of the claim (`pending` or `verified`).
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            The timestamp (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format) of when the claim was created.
      additionalProperties: false
      type: object
      required:
        - claim_type
        - legal_name
        - registration_number
        - date_of_incorporation
        - country_of_incorporation
        - entity_type
        - id
        - created_at
        - status
      title: RegistrationPersonClaimSummary
      description: Legal entity registration claim summary.
    ContactDetailsPersonClaimSummary:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        claim_type:
          const: contact_details
          title: Claim Type
        phone_number:
          type: string
          title: Phone Number
        email:
          anyOf:
            - type: string
            - type: 'null'
          title: Email
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: The status of the claim (`pending` or `verified`).
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            The timestamp (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format) of when the claim was created.
      additionalProperties: false
      type: object
      required:
        - claim_type
        - phone_number
        - id
        - created_at
        - status
      title: ContactDetailsPersonClaimSummary
      description: Legal entity contact details claim summary.
    LeiPersonClaimSummary:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        claim_type:
          const: lei
          title: Claim Type
        identifier:
          type: string
          title: Identifier
        expiry_date:
          type: string
          format: date
          title: Expiry Date
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: The status of the claim (`pending` or `verified`).
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            The timestamp (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format) of when the claim was created.
      additionalProperties: false
      type: object
      required:
        - claim_type
        - identifier
        - expiry_date
        - id
        - created_at
        - status
      title: LeiPersonClaimSummary
      description: LEI claim summary.
    RegisteredAddressPersonClaimSummary:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        line1:
          type: string
          title: Line1
        line2:
          anyOf:
            - type: string
            - type: 'null'
          title: Line2
        line3:
          anyOf:
            - type: string
            - type: 'null'
          title: Line3
        district_county:
          anyOf:
            - type: string
            - type: 'null'
          title: District County
        postal_code:
          type: string
          title: Postal Code
        city:
          type: string
          title: City
        country_code:
          type: string
          title: Country Code
        claim_type:
          const: registered_address
          title: Claim Type
        operating_address_is_same:
          type: boolean
          title: Operating Address Is Same
          default: false
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: The status of the claim (`pending` or `verified`).
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            The timestamp (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format) of when the claim was created.
      additionalProperties: false
      type: object
      required:
        - line1
        - postal_code
        - city
        - country_code
        - claim_type
        - id
        - created_at
        - status
      title: RegisteredAddressPersonClaimSummary
      description: Legal entity registered address claim summary.
    OperatingAddressPersonClaimSummary:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        line1:
          type: string
          title: Line1
        line2:
          anyOf:
            - type: string
            - type: 'null'
          title: Line2
        line3:
          anyOf:
            - type: string
            - type: 'null'
          title: Line3
        district_county:
          anyOf:
            - type: string
            - type: 'null'
          title: District County
        postal_code:
          type: string
          title: Postal Code
        city:
          type: string
          title: City
        country_code:
          type: string
          title: Country Code
        claim_type:
          const: operating_address
          title: Claim Type
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: The status of the claim (`pending` or `verified`).
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            The timestamp (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format) of when the claim was created.
      additionalProperties: false
      type: object
      required:
        - line1
        - postal_code
        - city
        - country_code
        - claim_type
        - id
        - created_at
        - status
      title: OperatingAddressPersonClaimSummary
      description: Legal entity operating address claim summary.
    BusinessNaturePersonClaimSummary:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        claim_type:
          const: business_nature
          title: Claim Type
        business_activity:
          $ref: '#/components/schemas/ClaimIndustry'
        business_activity_other:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Activity Other
        annual_turnover_eur:
          $ref: '#/components/schemas/EurAmountBand'
        is_regulated:
          type: boolean
          title: Is Regulated
        license_number:
          anyOf:
            - type: string
            - type: 'null'
          title: License Number
        issues_bearer_shares:
          type: boolean
          title: Issues Bearer Shares
        has_nominee_shareholders:
          type: boolean
          title: Has Nominee Shareholders
        has_shell_bank_relationships:
          type: boolean
          title: Has Shell Bank Relationships
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: The status of the claim (`pending` or `verified`).
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            The timestamp (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format) of when the claim was created.
      additionalProperties: false
      type: object
      required:
        - claim_type
        - business_activity
        - annual_turnover_eur
        - is_regulated
        - issues_bearer_shares
        - has_nominee_shareholders
        - has_shell_bank_relationships
        - id
        - created_at
        - status
      title: BusinessNaturePersonClaimSummary
      description: Business nature claim summary.
    ExpectedActivityPersonClaimSummary:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        claim_type:
          const: expected_activity
          title: Claim Type
        funding_currency:
          type: string
          title: Funding Currency
        asset_classes:
          items:
            type: string
          type: array
          title: Asset Classes
        annual_transactions:
          type: string
          title: Annual Transactions
        investment_amount:
          type: string
          title: Investment Amount
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: The status of the claim (`pending` or `verified`).
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            The timestamp (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format) of when the claim was created.
      additionalProperties: false
      type: object
      required:
        - claim_type
        - funding_currency
        - asset_classes
        - annual_transactions
        - investment_amount
        - id
        - created_at
        - status
      title: ExpectedActivityPersonClaimSummary
      description: Expected activity claim summary.
    RelationshipsPersonClaimSummary:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        claim_type:
          const: relationships
          title: Claim Type
        relationships:
          items:
            $ref: '#/components/schemas/RelationshipEntry-Output'
          type: array
          minItems: 1
          title: Relationships
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: The status of the claim (`pending` or `verified`).
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            The timestamp (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format) of when the claim was created.
      additionalProperties: false
      type: object
      required:
        - claim_type
        - relationships
        - id
        - created_at
        - status
      title: RelationshipsPersonClaimSummary
      description: Relationships claim summary.
    InvalidParam:
      properties:
        path:
          items:
            anyOf:
              - type: integer
              - type: string
          type: array
          title: Path
          description: Path to the field name (or index if a list) that errored.
        detail:
          type: string
          title: Detail
          description: Human-readable detail for error.
        code:
          type: string
          title: Code
          description: A machine-readable error code.
      type: object
      required:
        - path
        - detail
        - code
      title: InvalidParam
    NationalityEntry:
      properties:
        country_code:
          type: string
          title: Country Code
        basis:
          anyOf:
            - $ref: '#/components/schemas/NationalityBasis'
            - type: 'null'
      additionalProperties: false
      type: object
      required:
        - country_code
      title: NationalityEntry
    TaxResidencyEntry:
      properties:
        country_code:
          type: string
          title: Country Code
        tin:
          anyOf:
            - type: string
            - type: 'null'
          title: Tin
        tin_exemption_reason:
          anyOf:
            - $ref: '#/components/schemas/TinExemptionReason'
            - type: 'null'
      additionalProperties: false
      type: object
      required:
        - country_code
      title: TaxResidencyEntry
    ClaimEducationLevel:
      type: string
      enum:
        - none
        - secondary
        - bachelors
        - masters
        - doctorate
        - professional
      title: ClaimEducationLevel
      properties: {}
    ClaimEmploymentStatus:
      type: string
      enum:
        - employed
        - self_employed
        - retired
        - student
        - unemployed
      title: ClaimEmploymentStatus
      properties: {}
    ClaimIndustry:
      type: string
      enum:
        - accountancy
        - admin_secretarial
        - agricultural
        - arms_trade
        - catering_hospitality
        - company_services
        - consulting
        - creative_media
        - defence_military
        - education
        - emergency_services
        - energy
        - export_import
        - financial_services
        - gambling
        - government_public_sector
        - health_medical
        - legal
        - leisure_entertainment_tourism
        - manufacturing
        - marketing_pr_advertising
        - ngo
        - nonprofit_charity
        - oil_gas_mining
        - pharmaceuticals
        - precious_metals_stones
        - professional_services
        - property_construction_trade
        - retail
        - social_care_services
        - technology
        - telecommunications
        - transport_logistics
        - adult_entertainment
        - cannabis_cbd
        - cryptocurrencies
        - embassy_consulate
        - other
      title: ClaimIndustry
      properties: {}
    EurAmountBand:
      type: string
      enum:
        - lt_50k
        - 50k_100k
        - 100k_250k
        - 250k_500k
        - 500k_1m
        - 1m_3m
        - gt_3m
      title: EurAmountBand
      properties: {}
    ClaimIncomeSource:
      type: string
      enum:
        - salary
        - pension
        - rental_income
        - dividends
        - interest
      title: ClaimIncomeSource
      properties: {}
    ClaimWealthSource:
      type: string
      enum:
        - savings
        - inheritance
        - trust_fund
        - investments
        - borrowings
        - real_estate
      title: ClaimWealthSource
      properties: {}
    ClaimAssetClass:
      type: string
      enum:
        - treasury_bills
        - bonds
        - equities
        - etfs
        - mutual_funds
        - fx
        - cfds
        - derivatives
        - crypto
      title: ClaimAssetClass
      properties: {}
    ClaimRegistrationEntityType:
      type: string
      enum:
        - private_company
        - public_company
        - listed_company
        - investment_firm
        - pension_provident_fund
        - investment_fund
        - insurance_firm
        - trust
        - partnership
        - bank_emi
      title: ClaimRegistrationEntityType
      properties: {}
    RelationshipEntry-Input:
      properties:
        related_person:
          type: string
          title: Related Person
        relationship_type:
          $ref: '#/components/schemas/PersonRelationshipType'
        control_type:
          anyOf:
            - $ref: '#/components/schemas/ControlType'
            - type: 'null'
        ownership_percentage:
          anyOf:
            - type: number
            - type: string
            - type: 'null'
          title: Ownership Percentage
        appointment_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Appointment Date
        end_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: End Date
        position:
          anyOf:
            - type: string
            - type: 'null'
          title: Position
        authority_scope:
          anyOf:
            - type: string
            - type: 'null'
          title: Authority Scope
      additionalProperties: false
      type: object
      required:
        - related_person
        - relationship_type
      title: RelationshipEntry
      description: A single relationship entry within a relationships claim.
    RelationshipEntry-Output:
      properties:
        related_person:
          type: string
          title: Related Person
        relationship_type:
          $ref: '#/components/schemas/PersonRelationshipType'
        control_type:
          anyOf:
            - $ref: '#/components/schemas/ControlType'
            - type: 'null'
        ownership_percentage:
          anyOf:
            - type: string
            - type: 'null'
          title: Ownership Percentage
        appointment_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Appointment Date
        end_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: End Date
        position:
          anyOf:
            - type: string
            - type: 'null'
          title: Position
        authority_scope:
          anyOf:
            - type: string
            - type: 'null'
          title: Authority Scope
      additionalProperties: false
      type: object
      required:
        - related_person
        - relationship_type
      title: RelationshipEntry
      description: A single relationship entry within a relationships claim.
    NationalityBasis:
      type: string
      enum:
        - birth
        - naturalisation
        - descent
        - marriage
        - investment_programme
        - other
      title: NationalityBasis
      properties: {}
    TinExemptionReason:
      type: string
      enum:
        - not_issued
        - pending_application
        - not_required
      title: TinExemptionReason
      properties: {}
    PersonRelationshipType:
      type: string
      enum:
        - director
        - shareholder
        - beneficial_owner
        - trustee
        - settlor
        - authorised_signatory
        - senior_management
      title: PersonRelationshipType
      properties: {}
    ControlType:
      type: string
      enum:
        - ownership
        - voting
        - other
      title: ControlType
      properties: {}
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````