> ## 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 /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: []
tags:
  - description: Retrieve accounts, statements, and account documents.
    name: accounts
    x-group: Accounts
  - description: Read the audit trail of platform activity.
    name: activity
    x-group: Activity
  - description: Obtain OAuth access tokens for the Engine API.
    name: auth
    x-group: Authentication
  - description: Inspect the authenticated user or service actor.
    name: identity
    x-group: Identity
  - description: Retrieve fee schedules and billing information.
    name: billing
    x-group: Billing
  - description: Browse instruments and tradable products.
    name: catalog
    x-group: Catalog
  - description: Track onboarding applications through completion.
    name: onboarding
    x-group: Onboarding
  - description: Manage customer records and related person data.
    name: customers
    x-group: Customers
  - description: List platform events and inspect individual occurrences.
    name: events
    x-group: Events
  - description: Read positions, transactions, and account holdings.
    name: holdings
    x-group: Holdings
  - description: Retrieve legal agreements and required disclosures.
    name: legal-documents
    x-group: Legal Documents
  - description: Access prices and market data for instruments.
    name: market-data
    x-group: Market Data
  - description: Manage deposits, withdrawals, and funding accounts.
    name: payments
    x-group: Payments
  - description: Retrieve returns, earnings, and performance metrics.
    name: performance
    x-group: Performance
  - description: Place and manage orders, quotes, and trades.
    name: trading
    x-group: Trading
  - description: Read position and account valuations over time.
    name: valuation
    x-group: Valuation
  - description: Configure webhook endpoints and inspect deliveries.
    name: webhooks
    x-group: Webhooks
  - description: Upload files and retrieve stored documents.
    name: files
    x-group: Files
paths:
  /persons:
    post:
      tags:
        - customers
      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':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PersonCreationResponse'
          description: Created
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Bad Request
      security:
        - HTTPBearer: []
components:
  schemas:
    CreatePersonRequest:
      properties:
        claims:
          description: Identity and business claims for the person.
          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'
          minItems: 1
          title: Claims
          type: array
        person_type:
          allOf:
            - $ref: '#/components/schemas/PersonType'
          description: Whether the person is natural or legal.
      required:
        - person_type
        - claims
      title: CreatePersonRequest
      type: object
    PersonCreationResponse:
      properties:
        claims:
          description: Claims created for this person.
          items:
            anyOf:
              - $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'
          title: Claims
          type: array
        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.
          format: date-time
          title: Created At
          type: string
        full_name:
          description: Person's full name.
          title: Full Name
          type: string
        id:
          description: Unique resource identifier.
          title: Id
          type: string
        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.
          format: date-time
          title: Modified At
          type: string
        person_type:
          allOf:
            - $ref: '#/components/schemas/PersonType'
          description: Person type.
      required:
        - created_at
        - modified_at
        - id
        - person_type
        - full_name
        - claims
      title: PersonCreationResponse
      type: object
    Error:
      properties:
        code:
          description: A machine-readable error code.
          title: Code
          type: string
        context:
          additionalProperties:
            anyOf:
              - type: string
              - type: integer
          description: An optional object for adding extra context to the error.
          title: Context
          type: object
          x-remove-null-from-type-union: true
        detail:
          description: A human-readable description of the error.
          title: Detail
          type: string
        docs:
          description: A URL to documentation about this error code.
          title: Docs
          type: string
          x-remove-null-from-type-union: true
        params:
          description: An optional list of params that failed validation.
          items:
            $ref: '#/components/schemas/InvalidParam'
          title: Params
          type: array
          x-remove-null-from-type-union: true
      required:
        - detail
        - code
      title: Error
      type: object
    IdentityClaimSpec:
      additionalProperties: false
      description: Spec for identity claim data.
      properties:
        claim_type:
          const: identity
          title: Claim Type
        date_of_birth:
          format: date
          title: Date Of Birth
          type: string
        first_name:
          title: First Name
          type: string
        last_name:
          title: Last Name
          type: string
      required:
        - claim_type
        - first_name
        - last_name
        - date_of_birth
      title: IdentityClaimSpec
      type: object
    NationalitiesClaimSpec:
      additionalProperties: false
      description: Spec for nationalities claim data.
      properties:
        claim_type:
          const: nationalities
          title: Claim Type
        nationalities:
          items:
            $ref: '#/components/schemas/NationalityEntry'
          title: Nationalities
          type: array
      required:
        - claim_type
      title: NationalitiesClaimSpec
      type: object
    ResidenceClaimSpec:
      additionalProperties: false
      description: Spec for residence claim data (aligned with Address).
      properties:
        city:
          title: City
          type: string
        claim_type:
          const: residence
          title: Claim Type
        country_code:
          title: Country Code
          type: string
        district_county:
          anyOf:
            - type: string
            - type: 'null'
          title: District County
        line1:
          title: Line1
          type: string
        line2:
          anyOf:
            - type: string
            - type: 'null'
          title: Line2
        line3:
          anyOf:
            - type: string
            - type: 'null'
          title: Line3
        postal_code:
          title: Postal Code
          type: string
      required:
        - line1
        - postal_code
        - city
        - country_code
        - claim_type
      title: ResidenceClaimSpec
      type: object
    TaxResidenciesClaimSpec:
      additionalProperties: false
      description: Spec for tax residencies claim data.
      properties:
        claim_type:
          const: tax_residencies
          title: Claim Type
        tax_residencies:
          items:
            $ref: '#/components/schemas/TaxResidencyEntry'
          title: Tax Residencies
          type: array
      required:
        - claim_type
      title: TaxResidenciesClaimSpec
      type: object
    FatcaStatusClaimSpec:
      additionalProperties: false
      description: Spec for FATCA US-person status (natural or legal person).
      properties:
        claim_type:
          const: fatca_status
          title: Claim Type
        is_us_person:
          title: Is Us Person
          type: boolean
      required:
        - claim_type
        - is_us_person
      title: FatcaStatusClaimSpec
      type: object
    PepStatusClaimSpec:
      additionalProperties: false
      description: Spec for politically exposed person (PEP) declaration claim data.
      properties:
        claim_type:
          const: pep_status
          title: Claim Type
        has_pep_association:
          title: Has Pep Association
          type: boolean
        is_pep:
          title: Is Pep
          type: boolean
        pep_associate_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Pep Associate Name
        pep_associate_relationship:
          anyOf:
            - type: string
            - type: 'null'
          title: Pep Associate Relationship
        pep_role:
          anyOf:
            - type: string
            - type: 'null'
          title: Pep Role
        pep_role_end_date:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Pep Role End Date
        pep_role_start_date:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Pep Role Start Date
      required:
        - claim_type
        - is_pep
        - has_pep_association
      title: PepStatusClaimSpec
      type: object
    EducationLevelClaimSpec:
      additionalProperties: false
      description: Spec for education level claim data (MiFID II suitability).
      properties:
        claim_type:
          const: education_level
          title: Claim Type
        education_level:
          $ref: '#/components/schemas/ClaimEducationLevel'
      required:
        - claim_type
        - education_level
      title: EducationLevelClaimSpec
      type: object
    EmploymentClaimSpec:
      additionalProperties: false
      description: Spec for employment claim data (MiFID II suitability).
      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
      required:
        - claim_type
        - employment_status
      title: EmploymentClaimSpec
      type: object
    FinancialProfileClaimSpec:
      additionalProperties: false
      description: Spec for income and wealth financial profile claim data.
      properties:
        annual_income_eur:
          $ref: '#/components/schemas/EurAmountBand'
        claim_type:
          const: financial_profile
          title: Claim Type
        income_sources:
          items:
            $ref: '#/components/schemas/ClaimIncomeSource'
          minItems: 1
          title: Income Sources
          type: array
        net_worth_eur:
          $ref: '#/components/schemas/EurAmountBand'
        wealth_sources:
          items:
            $ref: '#/components/schemas/ClaimWealthSource'
          minItems: 1
          title: Wealth Sources
          type: array
      required:
        - claim_type
        - annual_income_eur
        - income_sources
        - net_worth_eur
        - wealth_sources
      title: FinancialProfileClaimSpec
      type: object
    InvestmentExperienceClaimSpec:
      additionalProperties: false
      description: Spec for prior investment experience claim data.
      properties:
        asset_classes:
          items:
            $ref: '#/components/schemas/ClaimAssetClass'
          title: Asset Classes
          type: array
        claim_type:
          const: investment_experience
          title: Claim Type
        has_prior_experience:
          title: Has Prior Experience
          type: boolean
      required:
        - claim_type
        - has_prior_experience
      title: InvestmentExperienceClaimSpec
      type: object
    RegistrationClaimSpec:
      additionalProperties: false
      description: Spec for legal entity registration claim data.
      properties:
        claim_type:
          const: registration
          title: Claim Type
        country_of_incorporation:
          title: Country Of Incorporation
          type: string
        date_of_incorporation:
          format: date
          title: Date Of Incorporation
          type: string
        entity_type:
          $ref: '#/components/schemas/ClaimRegistrationEntityType'
        legal_name:
          title: Legal Name
          type: string
        registration_number:
          title: Registration Number
          type: string
        trading_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Trading Name
      required:
        - claim_type
        - legal_name
        - registration_number
        - date_of_incorporation
        - country_of_incorporation
        - entity_type
      title: RegistrationClaimSpec
      type: object
    ContactDetailsClaimSpec:
      additionalProperties: false
      description: Spec for legal entity contact details claim data.
      properties:
        claim_type:
          const: contact_details
          title: Claim Type
        email:
          anyOf:
            - type: string
            - type: 'null'
          title: Email
        phone_number:
          title: Phone Number
          type: string
      required:
        - claim_type
        - phone_number
      title: ContactDetailsClaimSpec
      type: object
    LeiClaimSpec:
      additionalProperties: false
      description: Spec for Legal Entity Identifier (LEI) claim data.
      properties:
        claim_type:
          const: lei
          title: Claim Type
        expiry_date:
          format: date
          title: Expiry Date
          type: string
        identifier:
          title: Identifier
          type: string
      required:
        - claim_type
        - identifier
        - expiry_date
      title: LeiClaimSpec
      type: object
    RegisteredAddressClaimSpec:
      additionalProperties: false
      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.
      properties:
        city:
          title: City
          type: string
        claim_type:
          const: registered_address
          title: Claim Type
        country_code:
          title: Country Code
          type: string
        district_county:
          anyOf:
            - type: string
            - type: 'null'
          title: District County
        line1:
          title: Line1
          type: string
        line2:
          anyOf:
            - type: string
            - type: 'null'
          title: Line2
        line3:
          anyOf:
            - type: string
            - type: 'null'
          title: Line3
        operating_address_is_same:
          default: false
          title: Operating Address Is Same
          type: boolean
        postal_code:
          title: Postal Code
          type: string
      required:
        - line1
        - postal_code
        - city
        - country_code
        - claim_type
      title: RegisteredAddressClaimSpec
      type: object
    OperatingAddressClaimSpec:
      additionalProperties: false
      description: Spec for legal entity operating (principal place of business) address.
      properties:
        city:
          title: City
          type: string
        claim_type:
          const: operating_address
          title: Claim Type
        country_code:
          title: Country Code
          type: string
        district_county:
          anyOf:
            - type: string
            - type: 'null'
          title: District County
        line1:
          title: Line1
          type: string
        line2:
          anyOf:
            - type: string
            - type: 'null'
          title: Line2
        line3:
          anyOf:
            - type: string
            - type: 'null'
          title: Line3
        postal_code:
          title: Postal Code
          type: string
      required:
        - line1
        - postal_code
        - city
        - country_code
        - claim_type
      title: OperatingAddressClaimSpec
      type: object
    BusinessNatureClaimSpec:
      additionalProperties: false
      description: Spec for legal entity business nature and turnover claim data.
      properties:
        annual_turnover_eur:
          $ref: '#/components/schemas/EurAmountBand'
        business_activity:
          $ref: '#/components/schemas/ClaimIndustry'
        business_activity_other:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Activity Other
        claim_type:
          const: business_nature
          title: Claim Type
        has_nominee_shareholders:
          title: Has Nominee Shareholders
          type: boolean
        has_shell_bank_relationships:
          title: Has Shell Bank Relationships
          type: boolean
        is_regulated:
          title: Is Regulated
          type: boolean
        issues_bearer_shares:
          title: Issues Bearer Shares
          type: boolean
        license_number:
          anyOf:
            - type: string
            - type: 'null'
          title: License Number
      required:
        - claim_type
        - business_activity
        - annual_turnover_eur
        - is_regulated
        - issues_bearer_shares
        - has_nominee_shareholders
        - has_shell_bank_relationships
      title: BusinessNatureClaimSpec
      type: object
    ExpectedActivityClaimSpec:
      additionalProperties: false
      description: Spec for expected investment activity claim data.
      properties:
        annual_transactions:
          title: Annual Transactions
          type: string
        asset_classes:
          items:
            type: string
          title: Asset Classes
          type: array
        claim_type:
          const: expected_activity
          title: Claim Type
        funding_currency:
          title: Funding Currency
          type: string
        investment_amount:
          title: Investment Amount
          type: string
      required:
        - claim_type
        - funding_currency
        - asset_classes
        - annual_transactions
        - investment_amount
      title: ExpectedActivityClaimSpec
      type: object
    RelationshipsClaimSpec:
      additionalProperties: false
      description: Spec for person relationships (UBOs, directors, shareholders, etc.).
      properties:
        claim_type:
          const: relationships
          title: Claim Type
        relationships:
          items:
            $ref: '#/components/schemas/RelationshipEntry-Input'
          minItems: 1
          title: Relationships
          type: array
      required:
        - claim_type
        - relationships
      title: RelationshipsClaimSpec
      type: object
    PersonType:
      enum:
        - natural
        - legal
      properties: {}
      title: PersonType
      type: string
    IdentityPersonClaimSummary:
      additionalProperties: false
      properties:
        claim_type:
          const: identity
          title: Claim Type
        created_at:
          description: Time the claim was created.
          examples:
            - '2026-07-14T09:30:00Z'
          format: date-time
          title: Created At
          type: string
        date_of_birth:
          format: date
          title: Date Of Birth
          type: string
        first_name:
          title: First Name
          type: string
        id:
          description: Unique resource identifier.
          title: Id
          type: string
        last_name:
          title: Last Name
          type: string
        status:
          description: The status of the claim (`pending` or `verified`).
          enum:
            - pending
            - verified
          title: Status
          type: string
      required:
        - claim_type
        - first_name
        - last_name
        - date_of_birth
        - id
        - created_at
        - status
      title: IdentityPersonClaimSummary
      type: object
    NationalitiesPersonClaimSummary:
      additionalProperties: false
      properties:
        claim_type:
          const: nationalities
          title: Claim Type
        created_at:
          description: Time the claim was created.
          examples:
            - '2026-07-14T09:30:00Z'
          format: date-time
          title: Created At
          type: string
        id:
          description: Unique resource identifier.
          title: Id
          type: string
        nationalities:
          items:
            $ref: '#/components/schemas/NationalityEntry'
          title: Nationalities
          type: array
        status:
          description: The status of the claim (`pending` or `verified`).
          enum:
            - pending
            - verified
          title: Status
          type: string
      required:
        - claim_type
        - id
        - created_at
        - status
      title: NationalitiesPersonClaimSummary
      type: object
    ResidencePersonClaimSummary:
      additionalProperties: false
      properties:
        city:
          title: City
          type: string
        claim_type:
          const: residence
          title: Claim Type
        country_code:
          title: Country Code
          type: string
        created_at:
          description: Time the claim was created.
          examples:
            - '2026-07-14T09:30:00Z'
          format: date-time
          title: Created At
          type: string
        district_county:
          anyOf:
            - type: string
            - type: 'null'
          title: District County
        id:
          description: Unique resource identifier.
          title: Id
          type: string
        line1:
          title: Line1
          type: string
        line2:
          anyOf:
            - type: string
            - type: 'null'
          title: Line2
        line3:
          anyOf:
            - type: string
            - type: 'null'
          title: Line3
        postal_code:
          title: Postal Code
          type: string
        status:
          description: The status of the claim (`pending` or `verified`).
          enum:
            - pending
            - verified
          title: Status
          type: string
      required:
        - line1
        - postal_code
        - city
        - country_code
        - claim_type
        - id
        - created_at
        - status
      title: ResidencePersonClaimSummary
      type: object
    TaxResidenciesPersonClaimSummary:
      additionalProperties: false
      properties:
        claim_type:
          const: tax_residencies
          title: Claim Type
        created_at:
          description: Time the claim was created.
          examples:
            - '2026-07-14T09:30:00Z'
          format: date-time
          title: Created At
          type: string
        id:
          description: Unique resource identifier.
          title: Id
          type: string
        status:
          description: The status of the claim (`pending` or `verified`).
          enum:
            - pending
            - verified
          title: Status
          type: string
        tax_residencies:
          items:
            $ref: '#/components/schemas/TaxResidencyEntry'
          title: Tax Residencies
          type: array
      required:
        - claim_type
        - id
        - created_at
        - status
      title: TaxResidenciesPersonClaimSummary
      type: object
    FatcaStatusPersonClaimSummary:
      additionalProperties: false
      properties:
        claim_type:
          const: fatca_status
          title: Claim Type
        created_at:
          description: Time the claim was created.
          examples:
            - '2026-07-14T09:30:00Z'
          format: date-time
          title: Created At
          type: string
        id:
          description: Unique resource identifier.
          title: Id
          type: string
        is_us_person:
          title: Is Us Person
          type: boolean
        status:
          description: The status of the claim (`pending` or `verified`).
          enum:
            - pending
            - verified
          title: Status
          type: string
      required:
        - claim_type
        - is_us_person
        - id
        - created_at
        - status
      title: FatcaStatusPersonClaimSummary
      type: object
    PepStatusPersonClaimSummary:
      additionalProperties: false
      properties:
        claim_type:
          const: pep_status
          title: Claim Type
        created_at:
          description: Time the claim was created.
          examples:
            - '2026-07-14T09:30:00Z'
          format: date-time
          title: Created At
          type: string
        has_pep_association:
          title: Has Pep Association
          type: boolean
        id:
          description: Unique resource identifier.
          title: Id
          type: string
        is_pep:
          title: Is Pep
          type: boolean
        pep_associate_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Pep Associate Name
        pep_associate_relationship:
          anyOf:
            - type: string
            - type: 'null'
          title: Pep Associate Relationship
        pep_role:
          anyOf:
            - type: string
            - type: 'null'
          title: Pep Role
        pep_role_end_date:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Pep Role End Date
        pep_role_start_date:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Pep Role Start Date
        status:
          description: The status of the claim (`pending` or `verified`).
          enum:
            - pending
            - verified
          title: Status
          type: string
      required:
        - claim_type
        - is_pep
        - has_pep_association
        - id
        - created_at
        - status
      title: PepStatusPersonClaimSummary
      type: object
    EducationLevelPersonClaimSummary:
      additionalProperties: false
      properties:
        claim_type:
          const: education_level
          title: Claim Type
        created_at:
          description: Time the claim was created.
          examples:
            - '2026-07-14T09:30:00Z'
          format: date-time
          title: Created At
          type: string
        education_level:
          $ref: '#/components/schemas/ClaimEducationLevel'
        id:
          description: Unique resource identifier.
          title: Id
          type: string
        status:
          description: The status of the claim (`pending` or `verified`).
          enum:
            - pending
            - verified
          title: Status
          type: string
      required:
        - claim_type
        - education_level
        - id
        - created_at
        - status
      title: EducationLevelPersonClaimSummary
      type: object
    EmploymentPersonClaimSummary:
      additionalProperties: false
      properties:
        claim_type:
          const: employment
          title: Claim Type
        created_at:
          description: Time the claim was created.
          examples:
            - '2026-07-14T09:30:00Z'
          format: date-time
          title: Created At
          type: string
        employment_status:
          $ref: '#/components/schemas/ClaimEmploymentStatus'
        id:
          description: Unique resource identifier.
          title: Id
          type: string
        industry:
          anyOf:
            - $ref: '#/components/schemas/ClaimIndustry'
            - type: 'null'
        industry_other:
          anyOf:
            - type: string
            - type: 'null'
          title: Industry Other
        status:
          description: The status of the claim (`pending` or `verified`).
          enum:
            - pending
            - verified
          title: Status
          type: string
      required:
        - claim_type
        - employment_status
        - id
        - created_at
        - status
      title: EmploymentPersonClaimSummary
      type: object
    FinancialProfilePersonClaimSummary:
      additionalProperties: false
      properties:
        annual_income_eur:
          $ref: '#/components/schemas/EurAmountBand'
        claim_type:
          const: financial_profile
          title: Claim Type
        created_at:
          description: Time the claim was created.
          examples:
            - '2026-07-14T09:30:00Z'
          format: date-time
          title: Created At
          type: string
        id:
          description: Unique resource identifier.
          title: Id
          type: string
        income_sources:
          items:
            $ref: '#/components/schemas/ClaimIncomeSource'
          minItems: 1
          title: Income Sources
          type: array
        net_worth_eur:
          $ref: '#/components/schemas/EurAmountBand'
        status:
          description: The status of the claim (`pending` or `verified`).
          enum:
            - pending
            - verified
          title: Status
          type: string
        wealth_sources:
          items:
            $ref: '#/components/schemas/ClaimWealthSource'
          minItems: 1
          title: Wealth Sources
          type: array
      required:
        - claim_type
        - annual_income_eur
        - income_sources
        - net_worth_eur
        - wealth_sources
        - id
        - created_at
        - status
      title: FinancialProfilePersonClaimSummary
      type: object
    InvestmentExperiencePersonClaimSummary:
      additionalProperties: false
      properties:
        asset_classes:
          items:
            $ref: '#/components/schemas/ClaimAssetClass'
          title: Asset Classes
          type: array
        claim_type:
          const: investment_experience
          title: Claim Type
        created_at:
          description: Time the claim was created.
          examples:
            - '2026-07-14T09:30:00Z'
          format: date-time
          title: Created At
          type: string
        has_prior_experience:
          title: Has Prior Experience
          type: boolean
        id:
          description: Unique resource identifier.
          title: Id
          type: string
        status:
          description: The status of the claim (`pending` or `verified`).
          enum:
            - pending
            - verified
          title: Status
          type: string
      required:
        - claim_type
        - has_prior_experience
        - id
        - created_at
        - status
      title: InvestmentExperiencePersonClaimSummary
      type: object
    RegistrationPersonClaimSummary:
      additionalProperties: false
      properties:
        claim_type:
          const: registration
          title: Claim Type
        country_of_incorporation:
          title: Country Of Incorporation
          type: string
        created_at:
          description: Time the claim was created.
          examples:
            - '2026-07-14T09:30:00Z'
          format: date-time
          title: Created At
          type: string
        date_of_incorporation:
          format: date
          title: Date Of Incorporation
          type: string
        entity_type:
          $ref: '#/components/schemas/ClaimRegistrationEntityType'
        id:
          description: Unique resource identifier.
          title: Id
          type: string
        legal_name:
          title: Legal Name
          type: string
        registration_number:
          title: Registration Number
          type: string
        status:
          description: The status of the claim (`pending` or `verified`).
          enum:
            - pending
            - verified
          title: Status
          type: string
        trading_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Trading Name
      required:
        - claim_type
        - legal_name
        - registration_number
        - date_of_incorporation
        - country_of_incorporation
        - entity_type
        - id
        - created_at
        - status
      title: RegistrationPersonClaimSummary
      type: object
    ContactDetailsPersonClaimSummary:
      additionalProperties: false
      properties:
        claim_type:
          const: contact_details
          title: Claim Type
        created_at:
          description: Time the claim was created.
          examples:
            - '2026-07-14T09:30:00Z'
          format: date-time
          title: Created At
          type: string
        email:
          anyOf:
            - type: string
            - type: 'null'
          title: Email
        id:
          description: Unique resource identifier.
          title: Id
          type: string
        phone_number:
          title: Phone Number
          type: string
        status:
          description: The status of the claim (`pending` or `verified`).
          enum:
            - pending
            - verified
          title: Status
          type: string
      required:
        - claim_type
        - phone_number
        - id
        - created_at
        - status
      title: ContactDetailsPersonClaimSummary
      type: object
    LeiPersonClaimSummary:
      additionalProperties: false
      properties:
        claim_type:
          const: lei
          title: Claim Type
        created_at:
          description: Time the claim was created.
          examples:
            - '2026-07-14T09:30:00Z'
          format: date-time
          title: Created At
          type: string
        expiry_date:
          format: date
          title: Expiry Date
          type: string
        id:
          description: Unique resource identifier.
          title: Id
          type: string
        identifier:
          title: Identifier
          type: string
        status:
          description: The status of the claim (`pending` or `verified`).
          enum:
            - pending
            - verified
          title: Status
          type: string
      required:
        - claim_type
        - identifier
        - expiry_date
        - id
        - created_at
        - status
      title: LeiPersonClaimSummary
      type: object
    RegisteredAddressPersonClaimSummary:
      additionalProperties: false
      properties:
        city:
          title: City
          type: string
        claim_type:
          const: registered_address
          title: Claim Type
        country_code:
          title: Country Code
          type: string
        created_at:
          description: Time the claim was created.
          examples:
            - '2026-07-14T09:30:00Z'
          format: date-time
          title: Created At
          type: string
        district_county:
          anyOf:
            - type: string
            - type: 'null'
          title: District County
        id:
          description: Unique resource identifier.
          title: Id
          type: string
        line1:
          title: Line1
          type: string
        line2:
          anyOf:
            - type: string
            - type: 'null'
          title: Line2
        line3:
          anyOf:
            - type: string
            - type: 'null'
          title: Line3
        operating_address_is_same:
          default: false
          title: Operating Address Is Same
          type: boolean
        postal_code:
          title: Postal Code
          type: string
        status:
          description: The status of the claim (`pending` or `verified`).
          enum:
            - pending
            - verified
          title: Status
          type: string
      required:
        - line1
        - postal_code
        - city
        - country_code
        - claim_type
        - id
        - created_at
        - status
      title: RegisteredAddressPersonClaimSummary
      type: object
    OperatingAddressPersonClaimSummary:
      additionalProperties: false
      properties:
        city:
          title: City
          type: string
        claim_type:
          const: operating_address
          title: Claim Type
        country_code:
          title: Country Code
          type: string
        created_at:
          description: Time the claim was created.
          examples:
            - '2026-07-14T09:30:00Z'
          format: date-time
          title: Created At
          type: string
        district_county:
          anyOf:
            - type: string
            - type: 'null'
          title: District County
        id:
          description: Unique resource identifier.
          title: Id
          type: string
        line1:
          title: Line1
          type: string
        line2:
          anyOf:
            - type: string
            - type: 'null'
          title: Line2
        line3:
          anyOf:
            - type: string
            - type: 'null'
          title: Line3
        postal_code:
          title: Postal Code
          type: string
        status:
          description: The status of the claim (`pending` or `verified`).
          enum:
            - pending
            - verified
          title: Status
          type: string
      required:
        - line1
        - postal_code
        - city
        - country_code
        - claim_type
        - id
        - created_at
        - status
      title: OperatingAddressPersonClaimSummary
      type: object
    BusinessNaturePersonClaimSummary:
      additionalProperties: false
      properties:
        annual_turnover_eur:
          $ref: '#/components/schemas/EurAmountBand'
        business_activity:
          $ref: '#/components/schemas/ClaimIndustry'
        business_activity_other:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Activity Other
        claim_type:
          const: business_nature
          title: Claim Type
        created_at:
          description: Time the claim was created.
          examples:
            - '2026-07-14T09:30:00Z'
          format: date-time
          title: Created At
          type: string
        has_nominee_shareholders:
          title: Has Nominee Shareholders
          type: boolean
        has_shell_bank_relationships:
          title: Has Shell Bank Relationships
          type: boolean
        id:
          description: Unique resource identifier.
          title: Id
          type: string
        is_regulated:
          title: Is Regulated
          type: boolean
        issues_bearer_shares:
          title: Issues Bearer Shares
          type: boolean
        license_number:
          anyOf:
            - type: string
            - type: 'null'
          title: License Number
        status:
          description: The status of the claim (`pending` or `verified`).
          enum:
            - pending
            - verified
          title: Status
          type: string
      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
      type: object
    ExpectedActivityPersonClaimSummary:
      additionalProperties: false
      properties:
        annual_transactions:
          title: Annual Transactions
          type: string
        asset_classes:
          items:
            type: string
          title: Asset Classes
          type: array
        claim_type:
          const: expected_activity
          title: Claim Type
        created_at:
          description: Time the claim was created.
          examples:
            - '2026-07-14T09:30:00Z'
          format: date-time
          title: Created At
          type: string
        funding_currency:
          title: Funding Currency
          type: string
        id:
          description: Unique resource identifier.
          title: Id
          type: string
        investment_amount:
          title: Investment Amount
          type: string
        status:
          description: The status of the claim (`pending` or `verified`).
          enum:
            - pending
            - verified
          title: Status
          type: string
      required:
        - claim_type
        - funding_currency
        - asset_classes
        - annual_transactions
        - investment_amount
        - id
        - created_at
        - status
      title: ExpectedActivityPersonClaimSummary
      type: object
    RelationshipsPersonClaimSummary:
      additionalProperties: false
      properties:
        claim_type:
          const: relationships
          title: Claim Type
        created_at:
          description: Time the claim was created.
          examples:
            - '2026-07-14T09:30:00Z'
          format: date-time
          title: Created At
          type: string
        id:
          description: Unique resource identifier.
          title: Id
          type: string
        relationships:
          items:
            $ref: '#/components/schemas/RelationshipEntry-Output'
          minItems: 1
          title: Relationships
          type: array
        status:
          description: The status of the claim (`pending` or `verified`).
          enum:
            - pending
            - verified
          title: Status
          type: string
      required:
        - claim_type
        - relationships
        - id
        - created_at
        - status
      title: RelationshipsPersonClaimSummary
      type: object
    InvalidParam:
      properties:
        code:
          description: A machine-readable error code.
          title: Code
          type: string
        detail:
          description: Human-readable detail for error.
          title: Detail
          type: string
        path:
          description: Path to the field name (or index if a list) that errored.
          items:
            anyOf:
              - type: integer
              - type: string
          title: Path
          type: array
      required:
        - path
        - detail
        - code
      title: InvalidParam
      type: object
    NationalityEntry:
      additionalProperties: false
      properties:
        basis:
          anyOf:
            - $ref: '#/components/schemas/NationalityBasis'
            - type: 'null'
        country_code:
          title: Country Code
          type: string
      required:
        - country_code
      title: NationalityEntry
      type: object
    TaxResidencyEntry:
      additionalProperties: false
      properties:
        country_code:
          title: Country Code
          type: string
        tin:
          anyOf:
            - type: string
            - type: 'null'
          title: Tin
        tin_exemption_reason:
          anyOf:
            - $ref: '#/components/schemas/TinExemptionReason'
            - type: 'null'
      required:
        - country_code
      title: TaxResidencyEntry
      type: object
    ClaimEducationLevel:
      enum:
        - none
        - secondary
        - bachelors
        - masters
        - doctorate
        - professional
      properties: {}
      title: ClaimEducationLevel
      type: string
    ClaimEmploymentStatus:
      enum:
        - employed
        - self_employed
        - retired
        - student
        - unemployed
      properties: {}
      title: ClaimEmploymentStatus
      type: string
    ClaimIndustry:
      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
      properties: {}
      title: ClaimIndustry
      type: string
    EurAmountBand:
      enum:
        - lt_50k
        - 50k_100k
        - 100k_250k
        - 250k_500k
        - 500k_1m
        - 1m_3m
        - gt_3m
      properties: {}
      title: EurAmountBand
      type: string
    ClaimIncomeSource:
      enum:
        - salary
        - pension
        - rental_income
        - dividends
        - interest
      properties: {}
      title: ClaimIncomeSource
      type: string
    ClaimWealthSource:
      enum:
        - savings
        - inheritance
        - trust_fund
        - investments
        - borrowings
        - real_estate
      properties: {}
      title: ClaimWealthSource
      type: string
    ClaimAssetClass:
      enum:
        - treasury_bills
        - bonds
        - equities
        - etfs
        - mutual_funds
        - fx
        - cfds
        - derivatives
        - crypto
      properties: {}
      title: ClaimAssetClass
      type: string
    ClaimRegistrationEntityType:
      enum:
        - private_company
        - public_company
        - listed_company
        - investment_firm
        - pension_provident_fund
        - investment_fund
        - insurance_firm
        - trust
        - partnership
        - bank_emi
      properties: {}
      title: ClaimRegistrationEntityType
      type: string
    RelationshipEntry-Input:
      additionalProperties: false
      description: A single relationship entry within a relationships claim.
      properties:
        appointment_date:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Appointment Date
        authority_scope:
          anyOf:
            - type: string
            - type: 'null'
          title: Authority Scope
        control_type:
          anyOf:
            - $ref: '#/components/schemas/ControlType'
            - type: 'null'
        end_date:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: End Date
        ownership_percentage:
          anyOf:
            - type: number
            - type: string
            - type: 'null'
          title: Ownership Percentage
        position:
          anyOf:
            - type: string
            - type: 'null'
          title: Position
        related_person:
          title: Related Person
          type: string
        relationship_type:
          $ref: '#/components/schemas/PersonRelationshipType'
      required:
        - related_person
        - relationship_type
      title: RelationshipEntry
      type: object
    RelationshipEntry-Output:
      additionalProperties: false
      description: A single relationship entry within a relationships claim.
      properties:
        appointment_date:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Appointment Date
        authority_scope:
          anyOf:
            - type: string
            - type: 'null'
          title: Authority Scope
        control_type:
          anyOf:
            - $ref: '#/components/schemas/ControlType'
            - type: 'null'
        end_date:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: End Date
        ownership_percentage:
          anyOf:
            - type: string
            - type: 'null'
          title: Ownership Percentage
        position:
          anyOf:
            - type: string
            - type: 'null'
          title: Position
        related_person:
          title: Related Person
          type: string
        relationship_type:
          $ref: '#/components/schemas/PersonRelationshipType'
      required:
        - related_person
        - relationship_type
      title: RelationshipEntry
      type: object
    NationalityBasis:
      enum:
        - birth
        - naturalisation
        - descent
        - marriage
        - investment_programme
        - other
      properties: {}
      title: NationalityBasis
      type: string
    TinExemptionReason:
      enum:
        - not_issued
        - pending_application
        - not_required
      properties: {}
      title: TinExemptionReason
      type: string
    ControlType:
      enum:
        - ownership
        - voting
        - other
      properties: {}
      title: ControlType
      type: string
    PersonRelationshipType:
      enum:
        - director
        - shareholder
        - beneficial_owner
        - trustee
        - settlor
        - authorised_signatory
        - senior_management
      properties: {}
      title: PersonRelationshipType
      type: string
  securitySchemes:
    HTTPBearer:
      scheme: bearer
      type: http

````