---
title: "List claims for a person"
method: GET
path: "/persons/{person_id}/claims"
tags: ["customers"]
---

# List claims for a person

`GET /persons/{person_id}/claims`

List claims for a person by ID.

## Path parameters

- `person_id` string, required — The ID of the person.

## Query parameters

- `claim_type` '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'
- `status` 'pending' | 'verified'
- `include_history` boolean — 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.

## Response `200`

OK

- union[]
  - union
    - IdentityPersonClaim
      - `archived_at` string, date-time, nullable, required — Date and time a newer pending claim replaced this row; `null` if this is the current pending row.
      - `claim_type` 'identity', required
      - `created_at` string, date-time, required — Date and time the claim was created.
      - `date_of_birth` string, date, required
      - `first_name` string, required
      - `id` string, required — Unique resource identifier.
      - `last_name` string, required
      - `lifecycle` 'active' | 'in_flight' | 'historical', required — Derived lifecycle role from `status`, `archived_at`, and `superseded_at`.
      - `person` string, required — ID of the person this claim belongs to.
      - `status` 'pending' | 'verified', required — Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row.
      - `superseded_at` string, date-time, nullable, required — Date and time a newer verified claim replaced this row; `null` if this is the current row.
      - `verified_at` string, date-time, nullable, required — Date and time the claim was verified; `null` while pending.
    - NationalitiesPersonClaim
      - `archived_at` string, date-time, nullable, required — Date and time a newer pending claim replaced this row; `null` if this is the current pending row.
      - `claim_type` 'nationalities', required
      - `created_at` string, date-time, required — Date and time the claim was created.
      - `id` string, required — Unique resource identifier.
      - `lifecycle` 'active' | 'in_flight' | 'historical', required — Derived lifecycle role from `status`, `archived_at`, and `superseded_at`.
      - `nationalities` NationalityEntry[]
        - `basis` 'birth' | 'naturalisation' | 'descent' | 'marriage' | 'investment_programme' | 'other'
        - `country_code` string, required
      - `person` string, required — ID of the person this claim belongs to.
      - `status` 'pending' | 'verified', required — Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row.
      - `superseded_at` string, date-time, nullable, required — Date and time a newer verified claim replaced this row; `null` if this is the current row.
      - `verified_at` string, date-time, nullable, required — Date and time the claim was verified; `null` while pending.
    - ResidencePersonClaim
      - `archived_at` string, date-time, nullable, required — Date and time a newer pending claim replaced this row; `null` if this is the current pending row.
      - `city` string, required
      - `claim_type` 'residence', required
      - `country_code` string, required
      - `created_at` string, date-time, required — Date and time the claim was created.
      - `district_county` string, nullable
      - `id` string, required — Unique resource identifier.
      - `lifecycle` 'active' | 'in_flight' | 'historical', required — Derived lifecycle role from `status`, `archived_at`, and `superseded_at`.
      - `line1` string, required
      - `line2` string, nullable
      - `line3` string, nullable
      - `person` string, required — ID of the person this claim belongs to.
      - `postal_code` string, required
      - `status` 'pending' | 'verified', required — Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row.
      - `superseded_at` string, date-time, nullable, required — Date and time a newer verified claim replaced this row; `null` if this is the current row.
      - `verified_at` string, date-time, nullable, required — Date and time the claim was verified; `null` while pending.
    - TaxResidenciesPersonClaim
      - `archived_at` string, date-time, nullable, required — Date and time a newer pending claim replaced this row; `null` if this is the current pending row.
      - `claim_type` 'tax_residencies', required
      - `created_at` string, date-time, required — Date and time the claim was created.
      - `id` string, required — Unique resource identifier.
      - `lifecycle` 'active' | 'in_flight' | 'historical', required — Derived lifecycle role from `status`, `archived_at`, and `superseded_at`.
      - `person` string, required — ID of the person this claim belongs to.
      - `status` 'pending' | 'verified', required — Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row.
      - `superseded_at` string, date-time, nullable, required — Date and time a newer verified claim replaced this row; `null` if this is the current row.
      - `tax_residencies` TaxResidencyEntry[]
        - `country_code` string, required
        - `tin` string, nullable
        - `tin_exemption_reason` 'not_issued' | 'pending_application' | 'not_required'
      - `verified_at` string, date-time, nullable, required — Date and time the claim was verified; `null` while pending.
    - FatcaStatusPersonClaim
      - `archived_at` string, date-time, nullable, required — Date and time a newer pending claim replaced this row; `null` if this is the current pending row.
      - `claim_type` 'fatca_status', required
      - `created_at` string, date-time, required — Date and time the claim was created.
      - `id` string, required — Unique resource identifier.
      - `is_us_person` boolean, required
      - `lifecycle` 'active' | 'in_flight' | 'historical', required — Derived lifecycle role from `status`, `archived_at`, and `superseded_at`.
      - `person` string, required — ID of the person this claim belongs to.
      - `status` 'pending' | 'verified', required — Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row.
      - `superseded_at` string, date-time, nullable, required — Date and time a newer verified claim replaced this row; `null` if this is the current row.
      - `verified_at` string, date-time, nullable, required — Date and time the claim was verified; `null` while pending.
    - PepStatusPersonClaim
      - `archived_at` string, date-time, nullable, required — Date and time a newer pending claim replaced this row; `null` if this is the current pending row.
      - `claim_type` 'pep_status', required
      - `created_at` string, date-time, required — Date and time the claim was created.
      - `has_pep_association` boolean, required
      - `id` string, required — Unique resource identifier.
      - `is_pep` boolean, required
      - `lifecycle` 'active' | 'in_flight' | 'historical', required — Derived lifecycle role from `status`, `archived_at`, and `superseded_at`.
      - `pep_associate_name` string, nullable
      - `pep_associate_relationship` string, nullable
      - `pep_role` string, nullable
      - `pep_role_end_date` string, date, nullable
      - `pep_role_start_date` string, date, nullable
      - `person` string, required — ID of the person this claim belongs to.
      - `status` 'pending' | 'verified', required — Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row.
      - `superseded_at` string, date-time, nullable, required — Date and time a newer verified claim replaced this row; `null` if this is the current row.
      - `verified_at` string, date-time, nullable, required — Date and time the claim was verified; `null` while pending.
    - EducationLevelPersonClaim
      - `archived_at` string, date-time, nullable, required — Date and time a newer pending claim replaced this row; `null` if this is the current pending row.
      - `claim_type` 'education_level', required
      - `created_at` string, date-time, required — Date and time the claim was created.
      - `education_level` 'none' | 'secondary' | 'bachelors' | 'masters' | 'doctorate' | 'professional', required
      - `id` string, required — Unique resource identifier.
      - `lifecycle` 'active' | 'in_flight' | 'historical', required — Derived lifecycle role from `status`, `archived_at`, and `superseded_at`.
      - `person` string, required — ID of the person this claim belongs to.
      - `status` 'pending' | 'verified', required — Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row.
      - `superseded_at` string, date-time, nullable, required — Date and time a newer verified claim replaced this row; `null` if this is the current row.
      - `verified_at` string, date-time, nullable, required — Date and time the claim was verified; `null` while pending.
    - EmploymentPersonClaim
      - `archived_at` string, date-time, nullable, required — Date and time a newer pending claim replaced this row; `null` if this is the current pending row.
      - `claim_type` 'employment', required
      - `created_at` string, date-time, required — Date and time the claim was created.
      - `employment_status` 'employed' | 'self_employed' | 'retired' | 'student' | 'unemployed', required
      - `id` string, required — Unique resource identifier.
      - `industry` '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'
      - `industry_other` string, nullable
      - `lifecycle` 'active' | 'in_flight' | 'historical', required — Derived lifecycle role from `status`, `archived_at`, and `superseded_at`.
      - `person` string, required — ID of the person this claim belongs to.
      - `status` 'pending' | 'verified', required — Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row.
      - `superseded_at` string, date-time, nullable, required — Date and time a newer verified claim replaced this row; `null` if this is the current row.
      - `verified_at` string, date-time, nullable, required — Date and time the claim was verified; `null` while pending.
    - FinancialProfilePersonClaim
      - `annual_income_eur` 'lt_50k' | '50k_100k' | '100k_250k' | '250k_500k' | '500k_1m' | '1m_3m' | 'gt_3m', required
      - `archived_at` string, date-time, nullable, required — Date and time a newer pending claim replaced this row; `null` if this is the current pending row.
      - `claim_type` 'financial_profile', required
      - `created_at` string, date-time, required — Date and time the claim was created.
      - `id` string, required — Unique resource identifier.
      - `income_sources` ClaimIncomeSource[], required
      - `lifecycle` 'active' | 'in_flight' | 'historical', required — Derived lifecycle role from `status`, `archived_at`, and `superseded_at`.
      - `net_worth_eur` 'lt_50k' | '50k_100k' | '100k_250k' | '250k_500k' | '500k_1m' | '1m_3m' | 'gt_3m', required
      - `person` string, required — ID of the person this claim belongs to.
      - `status` 'pending' | 'verified', required — Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row.
      - `superseded_at` string, date-time, nullable, required — Date and time a newer verified claim replaced this row; `null` if this is the current row.
      - `verified_at` string, date-time, nullable, required — Date and time the claim was verified; `null` while pending.
      - `wealth_sources` ClaimWealthSource[], required
    - InvestmentExperiencePersonClaim
      - `archived_at` string, date-time, nullable, required — Date and time a newer pending claim replaced this row; `null` if this is the current pending row.
      - `asset_classes` ClaimAssetClass[]
      - `claim_type` 'investment_experience', required
      - `created_at` string, date-time, required — Date and time the claim was created.
      - `has_prior_experience` boolean, required
      - `id` string, required — Unique resource identifier.
      - `lifecycle` 'active' | 'in_flight' | 'historical', required — Derived lifecycle role from `status`, `archived_at`, and `superseded_at`.
      - `person` string, required — ID of the person this claim belongs to.
      - `status` 'pending' | 'verified', required — Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row.
      - `superseded_at` string, date-time, nullable, required — Date and time a newer verified claim replaced this row; `null` if this is the current row.
      - `verified_at` string, date-time, nullable, required — Date and time the claim was verified; `null` while pending.
    - RegistrationPersonClaim
      - `archived_at` string, date-time, nullable, required — Date and time a newer pending claim replaced this row; `null` if this is the current pending row.
      - `claim_type` 'registration', required
      - `country_of_incorporation` string, required
      - `created_at` string, date-time, required — Date and time the claim was created.
      - `date_of_incorporation` string, date, required
      - `entity_type` 'private_company' | 'public_company' | 'listed_company' | 'investment_firm' | 'pension_provident_fund' | 'investment_fund' | 'insurance_firm' | 'trust' | 'partnership' | 'bank_emi', required
      - `id` string, required — Unique resource identifier.
      - `legal_name` string, required
      - `lifecycle` 'active' | 'in_flight' | 'historical', required — Derived lifecycle role from `status`, `archived_at`, and `superseded_at`.
      - `person` string, required — ID of the person this claim belongs to.
      - `registration_number` string, required
      - `status` 'pending' | 'verified', required — Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row.
      - `superseded_at` string, date-time, nullable, required — Date and time a newer verified claim replaced this row; `null` if this is the current row.
      - `trading_name` string, nullable
      - `verified_at` string, date-time, nullable, required — Date and time the claim was verified; `null` while pending.
    - ContactDetailsPersonClaim
      - `archived_at` string, date-time, nullable, required — Date and time a newer pending claim replaced this row; `null` if this is the current pending row.
      - `claim_type` 'contact_details', required
      - `created_at` string, date-time, required — Date and time the claim was created.
      - `email` string, nullable
      - `id` string, required — Unique resource identifier.
      - `lifecycle` 'active' | 'in_flight' | 'historical', required — Derived lifecycle role from `status`, `archived_at`, and `superseded_at`.
      - `person` string, required — ID of the person this claim belongs to.
      - `phone_number` string, required
      - `status` 'pending' | 'verified', required — Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row.
      - `superseded_at` string, date-time, nullable, required — Date and time a newer verified claim replaced this row; `null` if this is the current row.
      - `verified_at` string, date-time, nullable, required — Date and time the claim was verified; `null` while pending.
    - LeiPersonClaim
      - `archived_at` string, date-time, nullable, required — Date and time a newer pending claim replaced this row; `null` if this is the current pending row.
      - `claim_type` 'lei', required
      - `created_at` string, date-time, required — Date and time the claim was created.
      - `expiry_date` string, date, required
      - `id` string, required — Unique resource identifier.
      - `identifier` string, required
      - `lifecycle` 'active' | 'in_flight' | 'historical', required — Derived lifecycle role from `status`, `archived_at`, and `superseded_at`.
      - `person` string, required — ID of the person this claim belongs to.
      - `status` 'pending' | 'verified', required — Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row.
      - `superseded_at` string, date-time, nullable, required — Date and time a newer verified claim replaced this row; `null` if this is the current row.
      - `verified_at` string, date-time, nullable, required — Date and time the claim was verified; `null` while pending.
    - RegisteredAddressPersonClaim
      - `archived_at` string, date-time, nullable, required — Date and time a newer pending claim replaced this row; `null` if this is the current pending row.
      - `city` string, required
      - `claim_type` 'registered_address', required
      - `country_code` string, required
      - `created_at` string, date-time, required — Date and time the claim was created.
      - `district_county` string, nullable
      - `id` string, required — Unique resource identifier.
      - `lifecycle` 'active' | 'in_flight' | 'historical', required — Derived lifecycle role from `status`, `archived_at`, and `superseded_at`.
      - `line1` string, required
      - `line2` string, nullable
      - `line3` string, nullable
      - `operating_address_is_same` boolean
      - `person` string, required — ID of the person this claim belongs to.
      - `postal_code` string, required
      - `status` 'pending' | 'verified', required — Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row.
      - `superseded_at` string, date-time, nullable, required — Date and time a newer verified claim replaced this row; `null` if this is the current row.
      - `verified_at` string, date-time, nullable, required — Date and time the claim was verified; `null` while pending.
    - OperatingAddressPersonClaim
      - `archived_at` string, date-time, nullable, required — Date and time a newer pending claim replaced this row; `null` if this is the current pending row.
      - `city` string, required
      - `claim_type` 'operating_address', required
      - `country_code` string, required
      - `created_at` string, date-time, required — Date and time the claim was created.
      - `district_county` string, nullable
      - `id` string, required — Unique resource identifier.
      - `lifecycle` 'active' | 'in_flight' | 'historical', required — Derived lifecycle role from `status`, `archived_at`, and `superseded_at`.
      - `line1` string, required
      - `line2` string, nullable
      - `line3` string, nullable
      - `person` string, required — ID of the person this claim belongs to.
      - `postal_code` string, required
      - `status` 'pending' | 'verified', required — Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row.
      - `superseded_at` string, date-time, nullable, required — Date and time a newer verified claim replaced this row; `null` if this is the current row.
      - `verified_at` string, date-time, nullable, required — Date and time the claim was verified; `null` while pending.
    - BusinessNaturePersonClaim
      - `annual_turnover_eur` 'lt_50k' | '50k_100k' | '100k_250k' | '250k_500k' | '500k_1m' | '1m_3m' | 'gt_3m', required
      - `archived_at` string, date-time, nullable, required — Date and time a newer pending claim replaced this row; `null` if this is the current pending row.
      - `business_activity` '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', required
      - `business_activity_other` string, nullable
      - `claim_type` 'business_nature', required
      - `created_at` string, date-time, required — Date and time the claim was created.
      - `has_nominee_shareholders` boolean, required
      - `has_shell_bank_relationships` boolean, required
      - `id` string, required — Unique resource identifier.
      - `is_regulated` boolean, required
      - `issues_bearer_shares` boolean, required
      - `license_number` string, nullable
      - `lifecycle` 'active' | 'in_flight' | 'historical', required — Derived lifecycle role from `status`, `archived_at`, and `superseded_at`.
      - `person` string, required — ID of the person this claim belongs to.
      - `status` 'pending' | 'verified', required — Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row.
      - `superseded_at` string, date-time, nullable, required — Date and time a newer verified claim replaced this row; `null` if this is the current row.
      - `verified_at` string, date-time, nullable, required — Date and time the claim was verified; `null` while pending.
    - ExpectedActivityPersonClaim
      - `annual_transactions` string, required
      - `archived_at` string, date-time, nullable, required — Date and time a newer pending claim replaced this row; `null` if this is the current pending row.
      - `asset_classes` string[], required
      - `claim_type` 'expected_activity', required
      - `created_at` string, date-time, required — Date and time the claim was created.
      - `funding_currency` string, required
      - `id` string, required — Unique resource identifier.
      - `investment_amount` string, required
      - `lifecycle` 'active' | 'in_flight' | 'historical', required — Derived lifecycle role from `status`, `archived_at`, and `superseded_at`.
      - `person` string, required — ID of the person this claim belongs to.
      - `status` 'pending' | 'verified', required — Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row.
      - `superseded_at` string, date-time, nullable, required — Date and time a newer verified claim replaced this row; `null` if this is the current row.
      - `verified_at` string, date-time, nullable, required — Date and time the claim was verified; `null` while pending.
    - RelationshipsPersonClaim
      - `archived_at` string, date-time, nullable, required — Date and time a newer pending claim replaced this row; `null` if this is the current pending row.
      - `claim_type` 'relationships', required
      - `created_at` string, date-time, required — Date and time the claim was created.
      - `id` string, required — Unique resource identifier.
      - `lifecycle` 'active' | 'in_flight' | 'historical', required — Derived lifecycle role from `status`, `archived_at`, and `superseded_at`.
      - `person` string, required — ID of the person this claim belongs to.
      - `relationships` RelationshipEntryOutput[], required
        - `appointment_date` string, date, nullable
        - `authority_scope` string, nullable
        - `control_type` 'ownership' | 'voting' | 'other'
        - `end_date` string, date, nullable
        - `ownership_percentage` string, nullable
        - `position` string, nullable
        - `related_person` string, required
        - `relationship_type` 'director' | 'shareholder' | 'beneficial_owner' | 'trustee' | 'settlor' | 'authorised_signatory' | 'senior_management', required
      - `status` 'pending' | 'verified', required — Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row.
      - `superseded_at` string, date-time, nullable, required — Date and time a newer verified claim replaced this row; `null` if this is the current row.
      - `verified_at` string, date-time, nullable, required — Date and time the claim was verified; `null` while pending.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/joinsophic/apis/sophic-engine-api.md) · [All operations](https://skmtc.net/joinsophic/apis/sophic-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/joinsophic/sophic-engine-api/revisions/5b4c43e2941b/schema)