> ## 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.

# List claims for a person

> List claims for a person by ID. Each row exposes `status`, `archived_at` (set on pending rows replaced by a newer pending), `superseded_at` (set on verified rows replaced by a newer verified), plus a derived `lifecycle` (`active`, `in_flight`, or `historical`) computed from those three columns. By default the response contains the full history for this person (every row, newest-first), giving callers an audit-ready view without a second request. Pass `include_history=false` to collapse to the two current rows per claim type -- the `active` verified row and the `in_flight` pending update, if any. Prefer reading `archived_at`/`superseded_at` directly if you only need to know whether a row is current; `lifecycle` is a convenience discriminator and will stay aligned with those columns.



## OpenAPI

````yaml https://api.engine.usesophic.com/openapi.json get /persons/{person_id}/claims
openapi: 3.1.0
info:
  title: Sophic Engine API
  version: 0.1.0
servers:
  - url: https://api.engine.usesophic.com/
security: []
paths:
  /persons/{person_id}/claims:
    get:
      summary: List claims for a person
      description: >-
        List claims for a person by ID. Each row exposes `status`, `archived_at`
        (set on pending rows replaced by a newer pending), `superseded_at` (set
        on verified rows replaced by a newer verified), plus a derived
        `lifecycle` (`active`, `in_flight`, or `historical`) computed from those
        three columns. By default the response contains the full history for
        this person (every row, newest-first), giving callers an audit-ready
        view without a second request. Pass `include_history=false` to collapse
        to the two current rows per claim type -- the `active` verified row and
        the `in_flight` pending update, if any. Prefer reading
        `archived_at`/`superseded_at` directly if you only need to know whether
        a row is current; `lifecycle` is a convenience discriminator and will
        stay aligned with those columns.
      operationId: list_person_claims_persons__person_id__claims_get
      parameters:
        - name: person_id
          in: path
          required: true
          schema:
            type: string
            description: The ID of the person.
            title: Person Id
          description: The ID of the person.
        - name: claim_type
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/ClaimType'
              - type: 'null'
            description: If set, only claims of this type.
            title: Claim Type
          description: If set, only claims of this type.
        - name: status
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/ClaimStatus'
              - type: 'null'
            description: >-
              Filter by claim status (pending or verified). If omitted, claims
              of all statuses are returned.
            title: Status
          description: >-
            Filter by claim status (pending or verified). If omitted, claims of
            all statuses are returned.
        - name: include_history
          in: query
          required: false
          schema:
            type: boolean
            description: >-
              Default `true`: every row for this person is returned (archived
              pendings and superseded verifieds included), newest-first. Set to
              `false` to collapse to the two current rows per claim type -- the
              `active` verified row and the `in_flight` pending update, if any.
            default: true
            title: Include History
          description: >-
            Default `true`: every row for this person is returned (archived
            pendings and superseded verifieds included), newest-first. Set to
            `false` to collapse to the two current rows per claim type -- the
            `active` verified row and the `in_flight` pending update, if any.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  oneOf:
                    - $ref: '#/components/schemas/IdentityPersonClaim'
                    - $ref: '#/components/schemas/NationalitiesPersonClaim'
                    - $ref: '#/components/schemas/ResidencePersonClaim'
                    - $ref: '#/components/schemas/TaxResidenciesPersonClaim'
                    - $ref: '#/components/schemas/FatcaStatusPersonClaim'
                    - $ref: '#/components/schemas/PepStatusPersonClaim'
                    - $ref: '#/components/schemas/EducationLevelPersonClaim'
                    - $ref: '#/components/schemas/EmploymentPersonClaim'
                    - $ref: '#/components/schemas/FinancialProfilePersonClaim'
                    - $ref: '#/components/schemas/InvestmentExperiencePersonClaim'
                    - $ref: '#/components/schemas/RegistrationPersonClaim'
                    - $ref: '#/components/schemas/ContactDetailsPersonClaim'
                    - $ref: '#/components/schemas/LeiPersonClaim'
                    - $ref: '#/components/schemas/RegisteredAddressPersonClaim'
                    - $ref: '#/components/schemas/OperatingAddressPersonClaim'
                    - $ref: '#/components/schemas/BusinessNaturePersonClaim'
                    - $ref: '#/components/schemas/ExpectedActivityPersonClaim'
                    - $ref: '#/components/schemas/RelationshipsPersonClaim'
                  discriminator:
                    propertyName: claim_type
                    mapping:
                      identity:
                        $ref: '#/components/schemas/IdentityPersonClaim'
                      nationalities:
                        $ref: '#/components/schemas/NationalitiesPersonClaim'
                      residence:
                        $ref: '#/components/schemas/ResidencePersonClaim'
                      tax_residencies:
                        $ref: '#/components/schemas/TaxResidenciesPersonClaim'
                      fatca_status:
                        $ref: '#/components/schemas/FatcaStatusPersonClaim'
                      pep_status:
                        $ref: '#/components/schemas/PepStatusPersonClaim'
                      education_level:
                        $ref: '#/components/schemas/EducationLevelPersonClaim'
                      employment:
                        $ref: '#/components/schemas/EmploymentPersonClaim'
                      financial_profile:
                        $ref: '#/components/schemas/FinancialProfilePersonClaim'
                      investment_experience:
                        $ref: '#/components/schemas/InvestmentExperiencePersonClaim'
                      registration:
                        $ref: '#/components/schemas/RegistrationPersonClaim'
                      contact_details:
                        $ref: '#/components/schemas/ContactDetailsPersonClaim'
                      lei:
                        $ref: '#/components/schemas/LeiPersonClaim'
                      registered_address:
                        $ref: '#/components/schemas/RegisteredAddressPersonClaim'
                      operating_address:
                        $ref: '#/components/schemas/OperatingAddressPersonClaim'
                      business_nature:
                        $ref: '#/components/schemas/BusinessNaturePersonClaim'
                      expected_activity:
                        $ref: '#/components/schemas/ExpectedActivityPersonClaim'
                      relationships:
                        $ref: '#/components/schemas/RelationshipsPersonClaim'
                title: Response List Person Claims Persons  Person Id  Claims Get
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - HTTPBearer: []
components:
  schemas:
    ClaimType:
      type: string
      enum:
        - identity
        - nationalities
        - residence
        - tax_residencies
        - fatca_status
        - pep_status
        - education_level
        - employment
        - financial_profile
        - investment_experience
        - expected_activity
        - relationships
        - registration
        - contact_details
        - lei
        - registered_address
        - operating_address
        - business_nature
      title: ClaimType
      properties: {}
    ClaimStatus:
      type: string
      enum:
        - pending
        - verified
      title: ClaimStatus
      properties: {}
    IdentityPersonClaim:
      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
        person:
          type: string
          title: Person
          description: ID of the person this claim belongs to.
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: >-
            The status of the claim (`pending` or `verified`). A verified claim
            whose `superseded_at` is non-null is historical -- a newer verified
            claim of the same type has taken over. A pending claim whose
            `archived_at` is non-null is historical -- a newer pending of the
            same type has replaced it.
        verified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Verified At
          description: >-
            When the claim was verified (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if still pending.
        superseded_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Superseded At
          description: >-
            When the claim was superseded by a newer verified claim (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current row for its type.
        archived_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Archived At
          description: >-
            When the pending claim was archived because a newer pending of the
            same `(person, claim_type)` replaced it (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current pending. Only ever set on
            pending rows.
        lifecycle:
          type: string
          enum:
            - active
            - in_flight
            - historical
          title: Lifecycle
          description: >-
            Derived role of this row within its `(person, claim_type)` group,
            computed from `status`, `archived_at`, and `superseded_at`. `active`
            is a verified row with `superseded_at IS NULL`. `in_flight` is a
            pending row with `archived_at IS NULL`. `historical` covers archived
            pendings and superseded verifieds kept for audit. Prefer reading the
            raw columns directly if you already know which case you care about;
            this field exists so consumers can keep a single discriminator
            across the three column values.
          readOnly: true
        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
        - person
        - created_at
        - status
        - verified_at
        - superseded_at
        - archived_at
        - lifecycle
      title: IdentityPersonClaim
      description: Identity claim response (first/last name, date of birth).
    NationalitiesPersonClaim:
      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
        person:
          type: string
          title: Person
          description: ID of the person this claim belongs to.
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: >-
            The status of the claim (`pending` or `verified`). A verified claim
            whose `superseded_at` is non-null is historical -- a newer verified
            claim of the same type has taken over. A pending claim whose
            `archived_at` is non-null is historical -- a newer pending of the
            same type has replaced it.
        verified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Verified At
          description: >-
            When the claim was verified (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if still pending.
        superseded_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Superseded At
          description: >-
            When the claim was superseded by a newer verified claim (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current row for its type.
        archived_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Archived At
          description: >-
            When the pending claim was archived because a newer pending of the
            same `(person, claim_type)` replaced it (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current pending. Only ever set on
            pending rows.
        lifecycle:
          type: string
          enum:
            - active
            - in_flight
            - historical
          title: Lifecycle
          description: >-
            Derived role of this row within its `(person, claim_type)` group,
            computed from `status`, `archived_at`, and `superseded_at`. `active`
            is a verified row with `superseded_at IS NULL`. `in_flight` is a
            pending row with `archived_at IS NULL`. `historical` covers archived
            pendings and superseded verifieds kept for audit. Prefer reading the
            raw columns directly if you already know which case you care about;
            this field exists so consumers can keep a single discriminator
            across the three column values.
          readOnly: true
        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
        - person
        - created_at
        - status
        - verified_at
        - superseded_at
        - archived_at
        - lifecycle
      title: NationalitiesPersonClaim
      description: Nationalities claim response.
    ResidencePersonClaim:
      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
        person:
          type: string
          title: Person
          description: ID of the person this claim belongs to.
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: >-
            The status of the claim (`pending` or `verified`). A verified claim
            whose `superseded_at` is non-null is historical -- a newer verified
            claim of the same type has taken over. A pending claim whose
            `archived_at` is non-null is historical -- a newer pending of the
            same type has replaced it.
        verified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Verified At
          description: >-
            When the claim was verified (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if still pending.
        superseded_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Superseded At
          description: >-
            When the claim was superseded by a newer verified claim (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current row for its type.
        archived_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Archived At
          description: >-
            When the pending claim was archived because a newer pending of the
            same `(person, claim_type)` replaced it (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current pending. Only ever set on
            pending rows.
        lifecycle:
          type: string
          enum:
            - active
            - in_flight
            - historical
          title: Lifecycle
          description: >-
            Derived role of this row within its `(person, claim_type)` group,
            computed from `status`, `archived_at`, and `superseded_at`. `active`
            is a verified row with `superseded_at IS NULL`. `in_flight` is a
            pending row with `archived_at IS NULL`. `historical` covers archived
            pendings and superseded verifieds kept for audit. Prefer reading the
            raw columns directly if you already know which case you care about;
            this field exists so consumers can keep a single discriminator
            across the three column values.
          readOnly: true
        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
        - person
        - created_at
        - status
        - verified_at
        - superseded_at
        - archived_at
        - lifecycle
      title: ResidencePersonClaim
      description: Residence (residential address) claim response.
    TaxResidenciesPersonClaim:
      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
        person:
          type: string
          title: Person
          description: ID of the person this claim belongs to.
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: >-
            The status of the claim (`pending` or `verified`). A verified claim
            whose `superseded_at` is non-null is historical -- a newer verified
            claim of the same type has taken over. A pending claim whose
            `archived_at` is non-null is historical -- a newer pending of the
            same type has replaced it.
        verified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Verified At
          description: >-
            When the claim was verified (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if still pending.
        superseded_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Superseded At
          description: >-
            When the claim was superseded by a newer verified claim (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current row for its type.
        archived_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Archived At
          description: >-
            When the pending claim was archived because a newer pending of the
            same `(person, claim_type)` replaced it (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current pending. Only ever set on
            pending rows.
        lifecycle:
          type: string
          enum:
            - active
            - in_flight
            - historical
          title: Lifecycle
          description: >-
            Derived role of this row within its `(person, claim_type)` group,
            computed from `status`, `archived_at`, and `superseded_at`. `active`
            is a verified row with `superseded_at IS NULL`. `in_flight` is a
            pending row with `archived_at IS NULL`. `historical` covers archived
            pendings and superseded verifieds kept for audit. Prefer reading the
            raw columns directly if you already know which case you care about;
            this field exists so consumers can keep a single discriminator
            across the three column values.
          readOnly: true
        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
        - person
        - created_at
        - status
        - verified_at
        - superseded_at
        - archived_at
        - lifecycle
      title: TaxResidenciesPersonClaim
      description: Tax residencies / CRS claim response.
    FatcaStatusPersonClaim:
      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
        person:
          type: string
          title: Person
          description: ID of the person this claim belongs to.
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: >-
            The status of the claim (`pending` or `verified`). A verified claim
            whose `superseded_at` is non-null is historical -- a newer verified
            claim of the same type has taken over. A pending claim whose
            `archived_at` is non-null is historical -- a newer pending of the
            same type has replaced it.
        verified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Verified At
          description: >-
            When the claim was verified (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if still pending.
        superseded_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Superseded At
          description: >-
            When the claim was superseded by a newer verified claim (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current row for its type.
        archived_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Archived At
          description: >-
            When the pending claim was archived because a newer pending of the
            same `(person, claim_type)` replaced it (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current pending. Only ever set on
            pending rows.
        lifecycle:
          type: string
          enum:
            - active
            - in_flight
            - historical
          title: Lifecycle
          description: >-
            Derived role of this row within its `(person, claim_type)` group,
            computed from `status`, `archived_at`, and `superseded_at`. `active`
            is a verified row with `superseded_at IS NULL`. `in_flight` is a
            pending row with `archived_at IS NULL`. `historical` covers archived
            pendings and superseded verifieds kept for audit. Prefer reading the
            raw columns directly if you already know which case you care about;
            this field exists so consumers can keep a single discriminator
            across the three column values.
          readOnly: true
        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
        - person
        - created_at
        - status
        - verified_at
        - superseded_at
        - archived_at
        - lifecycle
      title: FatcaStatusPersonClaim
      description: FATCA US-person status claim response.
    PepStatusPersonClaim:
      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
        person:
          type: string
          title: Person
          description: ID of the person this claim belongs to.
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: >-
            The status of the claim (`pending` or `verified`). A verified claim
            whose `superseded_at` is non-null is historical -- a newer verified
            claim of the same type has taken over. A pending claim whose
            `archived_at` is non-null is historical -- a newer pending of the
            same type has replaced it.
        verified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Verified At
          description: >-
            When the claim was verified (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if still pending.
        superseded_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Superseded At
          description: >-
            When the claim was superseded by a newer verified claim (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current row for its type.
        archived_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Archived At
          description: >-
            When the pending claim was archived because a newer pending of the
            same `(person, claim_type)` replaced it (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current pending. Only ever set on
            pending rows.
        lifecycle:
          type: string
          enum:
            - active
            - in_flight
            - historical
          title: Lifecycle
          description: >-
            Derived role of this row within its `(person, claim_type)` group,
            computed from `status`, `archived_at`, and `superseded_at`. `active`
            is a verified row with `superseded_at IS NULL`. `in_flight` is a
            pending row with `archived_at IS NULL`. `historical` covers archived
            pendings and superseded verifieds kept for audit. Prefer reading the
            raw columns directly if you already know which case you care about;
            this field exists so consumers can keep a single discriminator
            across the three column values.
          readOnly: true
        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
        - person
        - created_at
        - status
        - verified_at
        - superseded_at
        - archived_at
        - lifecycle
      title: PepStatusPersonClaim
      description: Politically-exposed-person claim response.
    EducationLevelPersonClaim:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        claim_type:
          const: education_level
          title: Claim Type
        education_level:
          $ref: '#/components/schemas/ClaimEducationLevel'
        person:
          type: string
          title: Person
          description: ID of the person this claim belongs to.
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: >-
            The status of the claim (`pending` or `verified`). A verified claim
            whose `superseded_at` is non-null is historical -- a newer verified
            claim of the same type has taken over. A pending claim whose
            `archived_at` is non-null is historical -- a newer pending of the
            same type has replaced it.
        verified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Verified At
          description: >-
            When the claim was verified (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if still pending.
        superseded_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Superseded At
          description: >-
            When the claim was superseded by a newer verified claim (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current row for its type.
        archived_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Archived At
          description: >-
            When the pending claim was archived because a newer pending of the
            same `(person, claim_type)` replaced it (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current pending. Only ever set on
            pending rows.
        lifecycle:
          type: string
          enum:
            - active
            - in_flight
            - historical
          title: Lifecycle
          description: >-
            Derived role of this row within its `(person, claim_type)` group,
            computed from `status`, `archived_at`, and `superseded_at`. `active`
            is a verified row with `superseded_at IS NULL`. `in_flight` is a
            pending row with `archived_at IS NULL`. `historical` covers archived
            pendings and superseded verifieds kept for audit. Prefer reading the
            raw columns directly if you already know which case you care about;
            this field exists so consumers can keep a single discriminator
            across the three column values.
          readOnly: true
        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
        - person
        - created_at
        - status
        - verified_at
        - superseded_at
        - archived_at
        - lifecycle
      title: EducationLevelPersonClaim
      description: Education level claim response (MiFID II suitability).
    EmploymentPersonClaim:
      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
        person:
          type: string
          title: Person
          description: ID of the person this claim belongs to.
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: >-
            The status of the claim (`pending` or `verified`). A verified claim
            whose `superseded_at` is non-null is historical -- a newer verified
            claim of the same type has taken over. A pending claim whose
            `archived_at` is non-null is historical -- a newer pending of the
            same type has replaced it.
        verified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Verified At
          description: >-
            When the claim was verified (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if still pending.
        superseded_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Superseded At
          description: >-
            When the claim was superseded by a newer verified claim (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current row for its type.
        archived_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Archived At
          description: >-
            When the pending claim was archived because a newer pending of the
            same `(person, claim_type)` replaced it (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current pending. Only ever set on
            pending rows.
        lifecycle:
          type: string
          enum:
            - active
            - in_flight
            - historical
          title: Lifecycle
          description: >-
            Derived role of this row within its `(person, claim_type)` group,
            computed from `status`, `archived_at`, and `superseded_at`. `active`
            is a verified row with `superseded_at IS NULL`. `in_flight` is a
            pending row with `archived_at IS NULL`. `historical` covers archived
            pendings and superseded verifieds kept for audit. Prefer reading the
            raw columns directly if you already know which case you care about;
            this field exists so consumers can keep a single discriminator
            across the three column values.
          readOnly: true
        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
        - person
        - created_at
        - status
        - verified_at
        - superseded_at
        - archived_at
        - lifecycle
      title: EmploymentPersonClaim
      description: Employment claim response (MiFID II suitability).
    FinancialProfilePersonClaim:
      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
        person:
          type: string
          title: Person
          description: ID of the person this claim belongs to.
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: >-
            The status of the claim (`pending` or `verified`). A verified claim
            whose `superseded_at` is non-null is historical -- a newer verified
            claim of the same type has taken over. A pending claim whose
            `archived_at` is non-null is historical -- a newer pending of the
            same type has replaced it.
        verified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Verified At
          description: >-
            When the claim was verified (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if still pending.
        superseded_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Superseded At
          description: >-
            When the claim was superseded by a newer verified claim (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current row for its type.
        archived_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Archived At
          description: >-
            When the pending claim was archived because a newer pending of the
            same `(person, claim_type)` replaced it (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current pending. Only ever set on
            pending rows.
        lifecycle:
          type: string
          enum:
            - active
            - in_flight
            - historical
          title: Lifecycle
          description: >-
            Derived role of this row within its `(person, claim_type)` group,
            computed from `status`, `archived_at`, and `superseded_at`. `active`
            is a verified row with `superseded_at IS NULL`. `in_flight` is a
            pending row with `archived_at IS NULL`. `historical` covers archived
            pendings and superseded verifieds kept for audit. Prefer reading the
            raw columns directly if you already know which case you care about;
            this field exists so consumers can keep a single discriminator
            across the three column values.
          readOnly: true
        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
        - person
        - created_at
        - status
        - verified_at
        - superseded_at
        - archived_at
        - lifecycle
      title: FinancialProfilePersonClaim
      description: Financial profile (income and wealth) claim response.
    InvestmentExperiencePersonClaim:
      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
        person:
          type: string
          title: Person
          description: ID of the person this claim belongs to.
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: >-
            The status of the claim (`pending` or `verified`). A verified claim
            whose `superseded_at` is non-null is historical -- a newer verified
            claim of the same type has taken over. A pending claim whose
            `archived_at` is non-null is historical -- a newer pending of the
            same type has replaced it.
        verified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Verified At
          description: >-
            When the claim was verified (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if still pending.
        superseded_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Superseded At
          description: >-
            When the claim was superseded by a newer verified claim (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current row for its type.
        archived_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Archived At
          description: >-
            When the pending claim was archived because a newer pending of the
            same `(person, claim_type)` replaced it (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current pending. Only ever set on
            pending rows.
        lifecycle:
          type: string
          enum:
            - active
            - in_flight
            - historical
          title: Lifecycle
          description: >-
            Derived role of this row within its `(person, claim_type)` group,
            computed from `status`, `archived_at`, and `superseded_at`. `active`
            is a verified row with `superseded_at IS NULL`. `in_flight` is a
            pending row with `archived_at IS NULL`. `historical` covers archived
            pendings and superseded verifieds kept for audit. Prefer reading the
            raw columns directly if you already know which case you care about;
            this field exists so consumers can keep a single discriminator
            across the three column values.
          readOnly: true
        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
        - person
        - created_at
        - status
        - verified_at
        - superseded_at
        - archived_at
        - lifecycle
      title: InvestmentExperiencePersonClaim
      description: Investment experience claim response.
    RegistrationPersonClaim:
      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'
        person:
          type: string
          title: Person
          description: ID of the person this claim belongs to.
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: >-
            The status of the claim (`pending` or `verified`). A verified claim
            whose `superseded_at` is non-null is historical -- a newer verified
            claim of the same type has taken over. A pending claim whose
            `archived_at` is non-null is historical -- a newer pending of the
            same type has replaced it.
        verified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Verified At
          description: >-
            When the claim was verified (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if still pending.
        superseded_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Superseded At
          description: >-
            When the claim was superseded by a newer verified claim (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current row for its type.
        archived_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Archived At
          description: >-
            When the pending claim was archived because a newer pending of the
            same `(person, claim_type)` replaced it (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current pending. Only ever set on
            pending rows.
        lifecycle:
          type: string
          enum:
            - active
            - in_flight
            - historical
          title: Lifecycle
          description: >-
            Derived role of this row within its `(person, claim_type)` group,
            computed from `status`, `archived_at`, and `superseded_at`. `active`
            is a verified row with `superseded_at IS NULL`. `in_flight` is a
            pending row with `archived_at IS NULL`. `historical` covers archived
            pendings and superseded verifieds kept for audit. Prefer reading the
            raw columns directly if you already know which case you care about;
            this field exists so consumers can keep a single discriminator
            across the three column values.
          readOnly: true
        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
        - person
        - created_at
        - status
        - verified_at
        - superseded_at
        - archived_at
        - lifecycle
      title: RegistrationPersonClaim
      description: Legal entity registration claim response.
    ContactDetailsPersonClaim:
      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
        person:
          type: string
          title: Person
          description: ID of the person this claim belongs to.
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: >-
            The status of the claim (`pending` or `verified`). A verified claim
            whose `superseded_at` is non-null is historical -- a newer verified
            claim of the same type has taken over. A pending claim whose
            `archived_at` is non-null is historical -- a newer pending of the
            same type has replaced it.
        verified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Verified At
          description: >-
            When the claim was verified (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if still pending.
        superseded_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Superseded At
          description: >-
            When the claim was superseded by a newer verified claim (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current row for its type.
        archived_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Archived At
          description: >-
            When the pending claim was archived because a newer pending of the
            same `(person, claim_type)` replaced it (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current pending. Only ever set on
            pending rows.
        lifecycle:
          type: string
          enum:
            - active
            - in_flight
            - historical
          title: Lifecycle
          description: >-
            Derived role of this row within its `(person, claim_type)` group,
            computed from `status`, `archived_at`, and `superseded_at`. `active`
            is a verified row with `superseded_at IS NULL`. `in_flight` is a
            pending row with `archived_at IS NULL`. `historical` covers archived
            pendings and superseded verifieds kept for audit. Prefer reading the
            raw columns directly if you already know which case you care about;
            this field exists so consumers can keep a single discriminator
            across the three column values.
          readOnly: true
        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
        - person
        - created_at
        - status
        - verified_at
        - superseded_at
        - archived_at
        - lifecycle
      title: ContactDetailsPersonClaim
      description: Legal entity contact details claim response.
    LeiPersonClaim:
      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
        person:
          type: string
          title: Person
          description: ID of the person this claim belongs to.
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: >-
            The status of the claim (`pending` or `verified`). A verified claim
            whose `superseded_at` is non-null is historical -- a newer verified
            claim of the same type has taken over. A pending claim whose
            `archived_at` is non-null is historical -- a newer pending of the
            same type has replaced it.
        verified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Verified At
          description: >-
            When the claim was verified (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if still pending.
        superseded_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Superseded At
          description: >-
            When the claim was superseded by a newer verified claim (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current row for its type.
        archived_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Archived At
          description: >-
            When the pending claim was archived because a newer pending of the
            same `(person, claim_type)` replaced it (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current pending. Only ever set on
            pending rows.
        lifecycle:
          type: string
          enum:
            - active
            - in_flight
            - historical
          title: Lifecycle
          description: >-
            Derived role of this row within its `(person, claim_type)` group,
            computed from `status`, `archived_at`, and `superseded_at`. `active`
            is a verified row with `superseded_at IS NULL`. `in_flight` is a
            pending row with `archived_at IS NULL`. `historical` covers archived
            pendings and superseded verifieds kept for audit. Prefer reading the
            raw columns directly if you already know which case you care about;
            this field exists so consumers can keep a single discriminator
            across the three column values.
          readOnly: true
        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
        - person
        - created_at
        - status
        - verified_at
        - superseded_at
        - archived_at
        - lifecycle
      title: LeiPersonClaim
      description: LEI claim response.
    RegisteredAddressPersonClaim:
      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
        person:
          type: string
          title: Person
          description: ID of the person this claim belongs to.
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: >-
            The status of the claim (`pending` or `verified`). A verified claim
            whose `superseded_at` is non-null is historical -- a newer verified
            claim of the same type has taken over. A pending claim whose
            `archived_at` is non-null is historical -- a newer pending of the
            same type has replaced it.
        verified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Verified At
          description: >-
            When the claim was verified (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if still pending.
        superseded_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Superseded At
          description: >-
            When the claim was superseded by a newer verified claim (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current row for its type.
        archived_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Archived At
          description: >-
            When the pending claim was archived because a newer pending of the
            same `(person, claim_type)` replaced it (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current pending. Only ever set on
            pending rows.
        lifecycle:
          type: string
          enum:
            - active
            - in_flight
            - historical
          title: Lifecycle
          description: >-
            Derived role of this row within its `(person, claim_type)` group,
            computed from `status`, `archived_at`, and `superseded_at`. `active`
            is a verified row with `superseded_at IS NULL`. `in_flight` is a
            pending row with `archived_at IS NULL`. `historical` covers archived
            pendings and superseded verifieds kept for audit. Prefer reading the
            raw columns directly if you already know which case you care about;
            this field exists so consumers can keep a single discriminator
            across the three column values.
          readOnly: true
        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
        - person
        - created_at
        - status
        - verified_at
        - superseded_at
        - archived_at
        - lifecycle
      title: RegisteredAddressPersonClaim
      description: Legal entity registered address claim response.
    OperatingAddressPersonClaim:
      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
        person:
          type: string
          title: Person
          description: ID of the person this claim belongs to.
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: >-
            The status of the claim (`pending` or `verified`). A verified claim
            whose `superseded_at` is non-null is historical -- a newer verified
            claim of the same type has taken over. A pending claim whose
            `archived_at` is non-null is historical -- a newer pending of the
            same type has replaced it.
        verified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Verified At
          description: >-
            When the claim was verified (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if still pending.
        superseded_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Superseded At
          description: >-
            When the claim was superseded by a newer verified claim (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current row for its type.
        archived_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Archived At
          description: >-
            When the pending claim was archived because a newer pending of the
            same `(person, claim_type)` replaced it (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current pending. Only ever set on
            pending rows.
        lifecycle:
          type: string
          enum:
            - active
            - in_flight
            - historical
          title: Lifecycle
          description: >-
            Derived role of this row within its `(person, claim_type)` group,
            computed from `status`, `archived_at`, and `superseded_at`. `active`
            is a verified row with `superseded_at IS NULL`. `in_flight` is a
            pending row with `archived_at IS NULL`. `historical` covers archived
            pendings and superseded verifieds kept for audit. Prefer reading the
            raw columns directly if you already know which case you care about;
            this field exists so consumers can keep a single discriminator
            across the three column values.
          readOnly: true
        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
        - person
        - created_at
        - status
        - verified_at
        - superseded_at
        - archived_at
        - lifecycle
      title: OperatingAddressPersonClaim
      description: Legal entity operating address claim response.
    BusinessNaturePersonClaim:
      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
        person:
          type: string
          title: Person
          description: ID of the person this claim belongs to.
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: >-
            The status of the claim (`pending` or `verified`). A verified claim
            whose `superseded_at` is non-null is historical -- a newer verified
            claim of the same type has taken over. A pending claim whose
            `archived_at` is non-null is historical -- a newer pending of the
            same type has replaced it.
        verified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Verified At
          description: >-
            When the claim was verified (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if still pending.
        superseded_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Superseded At
          description: >-
            When the claim was superseded by a newer verified claim (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current row for its type.
        archived_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Archived At
          description: >-
            When the pending claim was archived because a newer pending of the
            same `(person, claim_type)` replaced it (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current pending. Only ever set on
            pending rows.
        lifecycle:
          type: string
          enum:
            - active
            - in_flight
            - historical
          title: Lifecycle
          description: >-
            Derived role of this row within its `(person, claim_type)` group,
            computed from `status`, `archived_at`, and `superseded_at`. `active`
            is a verified row with `superseded_at IS NULL`. `in_flight` is a
            pending row with `archived_at IS NULL`. `historical` covers archived
            pendings and superseded verifieds kept for audit. Prefer reading the
            raw columns directly if you already know which case you care about;
            this field exists so consumers can keep a single discriminator
            across the three column values.
          readOnly: true
        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
        - person
        - created_at
        - status
        - verified_at
        - superseded_at
        - archived_at
        - lifecycle
      title: BusinessNaturePersonClaim
      description: Business nature / turnover claim response.
    ExpectedActivityPersonClaim:
      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
        person:
          type: string
          title: Person
          description: ID of the person this claim belongs to.
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: >-
            The status of the claim (`pending` or `verified`). A verified claim
            whose `superseded_at` is non-null is historical -- a newer verified
            claim of the same type has taken over. A pending claim whose
            `archived_at` is non-null is historical -- a newer pending of the
            same type has replaced it.
        verified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Verified At
          description: >-
            When the claim was verified (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if still pending.
        superseded_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Superseded At
          description: >-
            When the claim was superseded by a newer verified claim (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current row for its type.
        archived_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Archived At
          description: >-
            When the pending claim was archived because a newer pending of the
            same `(person, claim_type)` replaced it (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current pending. Only ever set on
            pending rows.
        lifecycle:
          type: string
          enum:
            - active
            - in_flight
            - historical
          title: Lifecycle
          description: >-
            Derived role of this row within its `(person, claim_type)` group,
            computed from `status`, `archived_at`, and `superseded_at`. `active`
            is a verified row with `superseded_at IS NULL`. `in_flight` is a
            pending row with `archived_at IS NULL`. `historical` covers archived
            pendings and superseded verifieds kept for audit. Prefer reading the
            raw columns directly if you already know which case you care about;
            this field exists so consumers can keep a single discriminator
            across the three column values.
          readOnly: true
        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
        - person
        - created_at
        - status
        - verified_at
        - superseded_at
        - archived_at
        - lifecycle
      title: ExpectedActivityPersonClaim
      description: Expected investment activity claim response.
    RelationshipsPersonClaim:
      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
        person:
          type: string
          title: Person
          description: ID of the person this claim belongs to.
        status:
          type: string
          enum:
            - pending
            - verified
          title: Status
          description: >-
            The status of the claim (`pending` or `verified`). A verified claim
            whose `superseded_at` is non-null is historical -- a newer verified
            claim of the same type has taken over. A pending claim whose
            `archived_at` is non-null is historical -- a newer pending of the
            same type has replaced it.
        verified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Verified At
          description: >-
            When the claim was verified (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if still pending.
        superseded_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Superseded At
          description: >-
            When the claim was superseded by a newer verified claim (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current row for its type.
        archived_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Archived At
          description: >-
            When the pending claim was archived because a newer pending of the
            same `(person, claim_type)` replaced it (in
            [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html)
            format); `null` if this is the current pending. Only ever set on
            pending rows.
        lifecycle:
          type: string
          enum:
            - active
            - in_flight
            - historical
          title: Lifecycle
          description: >-
            Derived role of this row within its `(person, claim_type)` group,
            computed from `status`, `archived_at`, and `superseded_at`. `active`
            is a verified row with `superseded_at IS NULL`. `in_flight` is a
            pending row with `archived_at IS NULL`. `historical` covers archived
            pendings and superseded verifieds kept for audit. Prefer reading the
            raw columns directly if you already know which case you care about;
            this field exists so consumers can keep a single discriminator
            across the three column values.
          readOnly: true
        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
        - person
        - created_at
        - status
        - verified_at
        - superseded_at
        - archived_at
        - lifecycle
      title: RelationshipsPersonClaim
      description: Relationships claim response (UBOs, directors, shareholders, etc.).
    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
    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-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.
    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
    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

````