> ## 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. # Retrieve a person claim > Retrieve a single claim for a person by person ID and claim ID. ## OpenAPI ````yaml /openapi.json get /persons/{person_id}/claims/{claim_id} openapi: 3.1.0 info: title: Sophic Engine API version: 0.1.0 servers: - url: https://api.engine.usesophic.com security: [] tags: - description: Retrieve accounts, statements, and account documents. name: accounts x-group: Accounts - description: Read the audit trail of platform activity. name: activity x-group: Activity - description: Obtain OAuth access tokens for the Engine API. name: auth x-group: Authentication - description: Inspect the authenticated user or service actor. name: identity x-group: Identity - description: Retrieve fee schedules and billing information. name: billing x-group: Billing - description: Browse instruments and tradable products. name: catalog x-group: Catalog - description: Track onboarding applications through completion. name: onboarding x-group: Onboarding - description: Manage customer records and related person data. name: customers x-group: Customers - description: List platform events and inspect individual occurrences. name: events x-group: Events - description: Read positions, transactions, and account holdings. name: holdings x-group: Holdings - description: Retrieve legal agreements and required disclosures. name: legal-documents x-group: Legal Documents - description: Access prices and market data for instruments. name: market-data x-group: Market Data - description: Manage deposits, withdrawals, and funding accounts. name: payments x-group: Payments - description: Retrieve returns, earnings, and performance metrics. name: performance x-group: Performance - description: Place and manage orders, quotes, and trades. name: trading x-group: Trading - description: Read position and account valuations over time. name: valuation x-group: Valuation - description: Configure webhook endpoints and inspect deliveries. name: webhooks x-group: Webhooks - description: Upload files and retrieve stored documents. name: files x-group: Files paths: /persons/{person_id}/claims/{claim_id}: get: tags: - customers summary: Retrieve a person claim description: Retrieve a single claim for a person by person ID and claim ID. operationId: get_person_claim_persons__person_id__claims__claim_id__get parameters: - description: The ID of the person. in: path name: person_id required: true schema: description: The ID of the person. title: Person Id type: string - description: The ID of the claim. in: path name: claim_id required: true schema: description: The ID of the claim. title: Claim Id type: string responses: '200': content: application/json: schema: discriminator: mapping: business_nature: $ref: '#/components/schemas/BusinessNaturePersonClaim' contact_details: $ref: '#/components/schemas/ContactDetailsPersonClaim' education_level: $ref: '#/components/schemas/EducationLevelPersonClaim' employment: $ref: '#/components/schemas/EmploymentPersonClaim' expected_activity: $ref: '#/components/schemas/ExpectedActivityPersonClaim' fatca_status: $ref: '#/components/schemas/FatcaStatusPersonClaim' financial_profile: $ref: '#/components/schemas/FinancialProfilePersonClaim' identity: $ref: '#/components/schemas/IdentityPersonClaim' investment_experience: $ref: '#/components/schemas/InvestmentExperiencePersonClaim' lei: $ref: '#/components/schemas/LeiPersonClaim' nationalities: $ref: '#/components/schemas/NationalitiesPersonClaim' operating_address: $ref: '#/components/schemas/OperatingAddressPersonClaim' pep_status: $ref: '#/components/schemas/PepStatusPersonClaim' registered_address: $ref: '#/components/schemas/RegisteredAddressPersonClaim' registration: $ref: '#/components/schemas/RegistrationPersonClaim' relationships: $ref: '#/components/schemas/RelationshipsPersonClaim' residence: $ref: '#/components/schemas/ResidencePersonClaim' tax_residencies: $ref: '#/components/schemas/TaxResidenciesPersonClaim' propertyName: claim_type 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' title: >- Response Get Person Claim Persons Person Id Claims Claim Id Get description: OK '400': content: application/json: schema: $ref: '#/components/schemas/Error' description: Bad Request security: - HTTPBearer: [] components: schemas: BusinessNaturePersonClaim: additionalProperties: false properties: annual_turnover_eur: $ref: '#/components/schemas/EurAmountBand' archived_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer pending claim replaced this row; `null` if this is the current pending row. examples: - '2026-07-20T08:15:00Z' title: Archived At business_activity: $ref: '#/components/schemas/ClaimIndustry' business_activity_other: anyOf: - type: string - type: 'null' title: Business Activity Other claim_type: const: business_nature title: Claim Type created_at: description: Date and time the claim was created. examples: - '2026-07-14T09:30:00Z' format: date-time title: Created At type: string has_nominee_shareholders: title: Has Nominee Shareholders type: boolean has_shell_bank_relationships: title: Has Shell Bank Relationships type: boolean id: description: Unique resource identifier. title: Id type: string is_regulated: title: Is Regulated type: boolean issues_bearer_shares: title: Issues Bearer Shares type: boolean license_number: anyOf: - type: string - type: 'null' title: License Number lifecycle: description: >- Derived lifecycle role from `status`, `archived_at`, and `superseded_at`. enum: - active - in_flight - historical readOnly: true title: Lifecycle type: string person: description: ID of the person this claim belongs to. title: Person type: string status: description: >- Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row. enum: - pending - verified title: Status type: string superseded_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer verified claim replaced this row; `null` if this is the current row. examples: - '2026-08-01T12:00:00Z' title: Superseded At verified_at: anyOf: - format: date-time type: string - type: 'null' description: Date and time the claim was verified; `null` while pending. examples: - '2026-07-14T10:00:00Z' title: Verified At 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 type: object ContactDetailsPersonClaim: additionalProperties: false properties: archived_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer pending claim replaced this row; `null` if this is the current pending row. examples: - '2026-07-20T08:15:00Z' title: Archived At claim_type: const: contact_details title: Claim Type created_at: description: Date and time the claim was created. examples: - '2026-07-14T09:30:00Z' format: date-time title: Created At type: string email: anyOf: - type: string - type: 'null' title: Email id: description: Unique resource identifier. title: Id type: string lifecycle: description: >- Derived lifecycle role from `status`, `archived_at`, and `superseded_at`. enum: - active - in_flight - historical readOnly: true title: Lifecycle type: string person: description: ID of the person this claim belongs to. title: Person type: string phone_number: title: Phone Number type: string status: description: >- Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row. enum: - pending - verified title: Status type: string superseded_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer verified claim replaced this row; `null` if this is the current row. examples: - '2026-08-01T12:00:00Z' title: Superseded At verified_at: anyOf: - format: date-time type: string - type: 'null' description: Date and time the claim was verified; `null` while pending. examples: - '2026-07-14T10:00:00Z' title: Verified At required: - claim_type - phone_number - id - person - created_at - status - verified_at - superseded_at - archived_at - lifecycle title: ContactDetailsPersonClaim type: object EducationLevelPersonClaim: additionalProperties: false properties: archived_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer pending claim replaced this row; `null` if this is the current pending row. examples: - '2026-07-20T08:15:00Z' title: Archived At claim_type: const: education_level title: Claim Type created_at: description: Date and time the claim was created. examples: - '2026-07-14T09:30:00Z' format: date-time title: Created At type: string education_level: $ref: '#/components/schemas/ClaimEducationLevel' id: description: Unique resource identifier. title: Id type: string lifecycle: description: >- Derived lifecycle role from `status`, `archived_at`, and `superseded_at`. enum: - active - in_flight - historical readOnly: true title: Lifecycle type: string person: description: ID of the person this claim belongs to. title: Person type: string status: description: >- Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row. enum: - pending - verified title: Status type: string superseded_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer verified claim replaced this row; `null` if this is the current row. examples: - '2026-08-01T12:00:00Z' title: Superseded At verified_at: anyOf: - format: date-time type: string - type: 'null' description: Date and time the claim was verified; `null` while pending. examples: - '2026-07-14T10:00:00Z' title: Verified At required: - claim_type - education_level - id - person - created_at - status - verified_at - superseded_at - archived_at - lifecycle title: EducationLevelPersonClaim type: object EmploymentPersonClaim: additionalProperties: false properties: archived_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer pending claim replaced this row; `null` if this is the current pending row. examples: - '2026-07-20T08:15:00Z' title: Archived At claim_type: const: employment title: Claim Type created_at: description: Date and time the claim was created. examples: - '2026-07-14T09:30:00Z' format: date-time title: Created At type: string employment_status: $ref: '#/components/schemas/ClaimEmploymentStatus' id: description: Unique resource identifier. title: Id type: string industry: anyOf: - $ref: '#/components/schemas/ClaimIndustry' - type: 'null' industry_other: anyOf: - type: string - type: 'null' title: Industry Other lifecycle: description: >- Derived lifecycle role from `status`, `archived_at`, and `superseded_at`. enum: - active - in_flight - historical readOnly: true title: Lifecycle type: string person: description: ID of the person this claim belongs to. title: Person type: string status: description: >- Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row. enum: - pending - verified title: Status type: string superseded_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer verified claim replaced this row; `null` if this is the current row. examples: - '2026-08-01T12:00:00Z' title: Superseded At verified_at: anyOf: - format: date-time type: string - type: 'null' description: Date and time the claim was verified; `null` while pending. examples: - '2026-07-14T10:00:00Z' title: Verified At required: - claim_type - employment_status - id - person - created_at - status - verified_at - superseded_at - archived_at - lifecycle title: EmploymentPersonClaim type: object ExpectedActivityPersonClaim: additionalProperties: false properties: annual_transactions: title: Annual Transactions type: string archived_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer pending claim replaced this row; `null` if this is the current pending row. examples: - '2026-07-20T08:15:00Z' title: Archived At asset_classes: items: type: string title: Asset Classes type: array claim_type: const: expected_activity title: Claim Type created_at: description: Date and time the claim was created. examples: - '2026-07-14T09:30:00Z' format: date-time title: Created At type: string funding_currency: title: Funding Currency type: string id: description: Unique resource identifier. title: Id type: string investment_amount: title: Investment Amount type: string lifecycle: description: >- Derived lifecycle role from `status`, `archived_at`, and `superseded_at`. enum: - active - in_flight - historical readOnly: true title: Lifecycle type: string person: description: ID of the person this claim belongs to. title: Person type: string status: description: >- Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row. enum: - pending - verified title: Status type: string superseded_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer verified claim replaced this row; `null` if this is the current row. examples: - '2026-08-01T12:00:00Z' title: Superseded At verified_at: anyOf: - format: date-time type: string - type: 'null' description: Date and time the claim was verified; `null` while pending. examples: - '2026-07-14T10:00:00Z' title: Verified At 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 type: object FatcaStatusPersonClaim: additionalProperties: false properties: archived_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer pending claim replaced this row; `null` if this is the current pending row. examples: - '2026-07-20T08:15:00Z' title: Archived At claim_type: const: fatca_status title: Claim Type created_at: description: Date and time the claim was created. examples: - '2026-07-14T09:30:00Z' format: date-time title: Created At type: string id: description: Unique resource identifier. title: Id type: string is_us_person: title: Is Us Person type: boolean lifecycle: description: >- Derived lifecycle role from `status`, `archived_at`, and `superseded_at`. enum: - active - in_flight - historical readOnly: true title: Lifecycle type: string person: description: ID of the person this claim belongs to. title: Person type: string status: description: >- Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row. enum: - pending - verified title: Status type: string superseded_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer verified claim replaced this row; `null` if this is the current row. examples: - '2026-08-01T12:00:00Z' title: Superseded At verified_at: anyOf: - format: date-time type: string - type: 'null' description: Date and time the claim was verified; `null` while pending. examples: - '2026-07-14T10:00:00Z' title: Verified At required: - claim_type - is_us_person - id - person - created_at - status - verified_at - superseded_at - archived_at - lifecycle title: FatcaStatusPersonClaim type: object FinancialProfilePersonClaim: additionalProperties: false properties: annual_income_eur: $ref: '#/components/schemas/EurAmountBand' archived_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer pending claim replaced this row; `null` if this is the current pending row. examples: - '2026-07-20T08:15:00Z' title: Archived At claim_type: const: financial_profile title: Claim Type created_at: description: Date and time the claim was created. examples: - '2026-07-14T09:30:00Z' format: date-time title: Created At type: string id: description: Unique resource identifier. title: Id type: string income_sources: items: $ref: '#/components/schemas/ClaimIncomeSource' minItems: 1 title: Income Sources type: array lifecycle: description: >- Derived lifecycle role from `status`, `archived_at`, and `superseded_at`. enum: - active - in_flight - historical readOnly: true title: Lifecycle type: string net_worth_eur: $ref: '#/components/schemas/EurAmountBand' person: description: ID of the person this claim belongs to. title: Person type: string status: description: >- Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row. enum: - pending - verified title: Status type: string superseded_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer verified claim replaced this row; `null` if this is the current row. examples: - '2026-08-01T12:00:00Z' title: Superseded At verified_at: anyOf: - format: date-time type: string - type: 'null' description: Date and time the claim was verified; `null` while pending. examples: - '2026-07-14T10:00:00Z' title: Verified At wealth_sources: items: $ref: '#/components/schemas/ClaimWealthSource' minItems: 1 title: Wealth Sources type: array required: - claim_type - annual_income_eur - income_sources - net_worth_eur - wealth_sources - id - person - created_at - status - verified_at - superseded_at - archived_at - lifecycle title: FinancialProfilePersonClaim type: object IdentityPersonClaim: additionalProperties: false properties: archived_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer pending claim replaced this row; `null` if this is the current pending row. examples: - '2026-07-20T08:15:00Z' title: Archived At claim_type: const: identity title: Claim Type created_at: description: Date and time the claim was created. examples: - '2026-07-14T09:30:00Z' format: date-time title: Created At type: string date_of_birth: format: date title: Date Of Birth type: string first_name: title: First Name type: string id: description: Unique resource identifier. title: Id type: string last_name: title: Last Name type: string lifecycle: description: >- Derived lifecycle role from `status`, `archived_at`, and `superseded_at`. enum: - active - in_flight - historical readOnly: true title: Lifecycle type: string person: description: ID of the person this claim belongs to. title: Person type: string status: description: >- Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row. enum: - pending - verified title: Status type: string superseded_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer verified claim replaced this row; `null` if this is the current row. examples: - '2026-08-01T12:00:00Z' title: Superseded At verified_at: anyOf: - format: date-time type: string - type: 'null' description: Date and time the claim was verified; `null` while pending. examples: - '2026-07-14T10:00:00Z' title: Verified At required: - claim_type - first_name - last_name - date_of_birth - id - person - created_at - status - verified_at - superseded_at - archived_at - lifecycle title: IdentityPersonClaim type: object InvestmentExperiencePersonClaim: additionalProperties: false properties: archived_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer pending claim replaced this row; `null` if this is the current pending row. examples: - '2026-07-20T08:15:00Z' title: Archived At asset_classes: items: $ref: '#/components/schemas/ClaimAssetClass' title: Asset Classes type: array claim_type: const: investment_experience title: Claim Type created_at: description: Date and time the claim was created. examples: - '2026-07-14T09:30:00Z' format: date-time title: Created At type: string has_prior_experience: title: Has Prior Experience type: boolean id: description: Unique resource identifier. title: Id type: string lifecycle: description: >- Derived lifecycle role from `status`, `archived_at`, and `superseded_at`. enum: - active - in_flight - historical readOnly: true title: Lifecycle type: string person: description: ID of the person this claim belongs to. title: Person type: string status: description: >- Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row. enum: - pending - verified title: Status type: string superseded_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer verified claim replaced this row; `null` if this is the current row. examples: - '2026-08-01T12:00:00Z' title: Superseded At verified_at: anyOf: - format: date-time type: string - type: 'null' description: Date and time the claim was verified; `null` while pending. examples: - '2026-07-14T10:00:00Z' title: Verified At required: - claim_type - has_prior_experience - id - person - created_at - status - verified_at - superseded_at - archived_at - lifecycle title: InvestmentExperiencePersonClaim type: object LeiPersonClaim: additionalProperties: false properties: archived_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer pending claim replaced this row; `null` if this is the current pending row. examples: - '2026-07-20T08:15:00Z' title: Archived At claim_type: const: lei title: Claim Type created_at: description: Date and time the claim was created. examples: - '2026-07-14T09:30:00Z' format: date-time title: Created At type: string expiry_date: format: date title: Expiry Date type: string id: description: Unique resource identifier. title: Id type: string identifier: title: Identifier type: string lifecycle: description: >- Derived lifecycle role from `status`, `archived_at`, and `superseded_at`. enum: - active - in_flight - historical readOnly: true title: Lifecycle type: string person: description: ID of the person this claim belongs to. title: Person type: string status: description: >- Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row. enum: - pending - verified title: Status type: string superseded_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer verified claim replaced this row; `null` if this is the current row. examples: - '2026-08-01T12:00:00Z' title: Superseded At verified_at: anyOf: - format: date-time type: string - type: 'null' description: Date and time the claim was verified; `null` while pending. examples: - '2026-07-14T10:00:00Z' title: Verified At required: - claim_type - identifier - expiry_date - id - person - created_at - status - verified_at - superseded_at - archived_at - lifecycle title: LeiPersonClaim type: object NationalitiesPersonClaim: additionalProperties: false properties: archived_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer pending claim replaced this row; `null` if this is the current pending row. examples: - '2026-07-20T08:15:00Z' title: Archived At claim_type: const: nationalities title: Claim Type created_at: description: Date and time the claim was created. examples: - '2026-07-14T09:30:00Z' format: date-time title: Created At type: string id: description: Unique resource identifier. title: Id type: string lifecycle: description: >- Derived lifecycle role from `status`, `archived_at`, and `superseded_at`. enum: - active - in_flight - historical readOnly: true title: Lifecycle type: string nationalities: items: $ref: '#/components/schemas/NationalityEntry' title: Nationalities type: array person: description: ID of the person this claim belongs to. title: Person type: string status: description: >- Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row. enum: - pending - verified title: Status type: string superseded_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer verified claim replaced this row; `null` if this is the current row. examples: - '2026-08-01T12:00:00Z' title: Superseded At verified_at: anyOf: - format: date-time type: string - type: 'null' description: Date and time the claim was verified; `null` while pending. examples: - '2026-07-14T10:00:00Z' title: Verified At required: - claim_type - id - person - created_at - status - verified_at - superseded_at - archived_at - lifecycle title: NationalitiesPersonClaim type: object OperatingAddressPersonClaim: additionalProperties: false properties: archived_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer pending claim replaced this row; `null` if this is the current pending row. examples: - '2026-07-20T08:15:00Z' title: Archived At city: title: City type: string claim_type: const: operating_address title: Claim Type country_code: title: Country Code type: string created_at: description: Date and time the claim was created. examples: - '2026-07-14T09:30:00Z' format: date-time title: Created At type: string district_county: anyOf: - type: string - type: 'null' title: District County id: description: Unique resource identifier. title: Id type: string lifecycle: description: >- Derived lifecycle role from `status`, `archived_at`, and `superseded_at`. enum: - active - in_flight - historical readOnly: true title: Lifecycle type: string line1: title: Line1 type: string line2: anyOf: - type: string - type: 'null' title: Line2 line3: anyOf: - type: string - type: 'null' title: Line3 person: description: ID of the person this claim belongs to. title: Person type: string postal_code: title: Postal Code type: string status: description: >- Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row. enum: - pending - verified title: Status type: string superseded_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer verified claim replaced this row; `null` if this is the current row. examples: - '2026-08-01T12:00:00Z' title: Superseded At verified_at: anyOf: - format: date-time type: string - type: 'null' description: Date and time the claim was verified; `null` while pending. examples: - '2026-07-14T10:00:00Z' title: Verified At required: - line1 - postal_code - city - country_code - claim_type - id - person - created_at - status - verified_at - superseded_at - archived_at - lifecycle title: OperatingAddressPersonClaim type: object PepStatusPersonClaim: additionalProperties: false properties: archived_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer pending claim replaced this row; `null` if this is the current pending row. examples: - '2026-07-20T08:15:00Z' title: Archived At claim_type: const: pep_status title: Claim Type created_at: description: Date and time the claim was created. examples: - '2026-07-14T09:30:00Z' format: date-time title: Created At type: string has_pep_association: title: Has Pep Association type: boolean id: description: Unique resource identifier. title: Id type: string is_pep: title: Is Pep type: boolean lifecycle: description: >- Derived lifecycle role from `status`, `archived_at`, and `superseded_at`. enum: - active - in_flight - historical readOnly: true title: Lifecycle type: string pep_associate_name: anyOf: - type: string - type: 'null' title: Pep Associate Name pep_associate_relationship: anyOf: - type: string - type: 'null' title: Pep Associate Relationship pep_role: anyOf: - type: string - type: 'null' title: Pep Role pep_role_end_date: anyOf: - format: date type: string - type: 'null' title: Pep Role End Date pep_role_start_date: anyOf: - format: date type: string - type: 'null' title: Pep Role Start Date person: description: ID of the person this claim belongs to. title: Person type: string status: description: >- Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row. enum: - pending - verified title: Status type: string superseded_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer verified claim replaced this row; `null` if this is the current row. examples: - '2026-08-01T12:00:00Z' title: Superseded At verified_at: anyOf: - format: date-time type: string - type: 'null' description: Date and time the claim was verified; `null` while pending. examples: - '2026-07-14T10:00:00Z' title: Verified At required: - claim_type - is_pep - has_pep_association - id - person - created_at - status - verified_at - superseded_at - archived_at - lifecycle title: PepStatusPersonClaim type: object RegisteredAddressPersonClaim: additionalProperties: false properties: archived_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer pending claim replaced this row; `null` if this is the current pending row. examples: - '2026-07-20T08:15:00Z' title: Archived At city: title: City type: string claim_type: const: registered_address title: Claim Type country_code: title: Country Code type: string created_at: description: Date and time the claim was created. examples: - '2026-07-14T09:30:00Z' format: date-time title: Created At type: string district_county: anyOf: - type: string - type: 'null' title: District County id: description: Unique resource identifier. title: Id type: string lifecycle: description: >- Derived lifecycle role from `status`, `archived_at`, and `superseded_at`. enum: - active - in_flight - historical readOnly: true title: Lifecycle type: string line1: title: Line1 type: string line2: anyOf: - type: string - type: 'null' title: Line2 line3: anyOf: - type: string - type: 'null' title: Line3 operating_address_is_same: default: false title: Operating Address Is Same type: boolean person: description: ID of the person this claim belongs to. title: Person type: string postal_code: title: Postal Code type: string status: description: >- Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row. enum: - pending - verified title: Status type: string superseded_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer verified claim replaced this row; `null` if this is the current row. examples: - '2026-08-01T12:00:00Z' title: Superseded At verified_at: anyOf: - format: date-time type: string - type: 'null' description: Date and time the claim was verified; `null` while pending. examples: - '2026-07-14T10:00:00Z' title: Verified At required: - line1 - postal_code - city - country_code - claim_type - id - person - created_at - status - verified_at - superseded_at - archived_at - lifecycle title: RegisteredAddressPersonClaim type: object RegistrationPersonClaim: additionalProperties: false properties: archived_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer pending claim replaced this row; `null` if this is the current pending row. examples: - '2026-07-20T08:15:00Z' title: Archived At claim_type: const: registration title: Claim Type country_of_incorporation: title: Country Of Incorporation type: string created_at: description: Date and time the claim was created. examples: - '2026-07-14T09:30:00Z' format: date-time title: Created At type: string date_of_incorporation: format: date title: Date Of Incorporation type: string entity_type: $ref: '#/components/schemas/ClaimRegistrationEntityType' id: description: Unique resource identifier. title: Id type: string legal_name: title: Legal Name type: string lifecycle: description: >- Derived lifecycle role from `status`, `archived_at`, and `superseded_at`. enum: - active - in_flight - historical readOnly: true title: Lifecycle type: string person: description: ID of the person this claim belongs to. title: Person type: string registration_number: title: Registration Number type: string status: description: >- Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row. enum: - pending - verified title: Status type: string superseded_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer verified claim replaced this row; `null` if this is the current row. examples: - '2026-08-01T12:00:00Z' title: Superseded At trading_name: anyOf: - type: string - type: 'null' title: Trading Name verified_at: anyOf: - format: date-time type: string - type: 'null' description: Date and time the claim was verified; `null` while pending. examples: - '2026-07-14T10:00:00Z' title: Verified At 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 type: object RelationshipsPersonClaim: additionalProperties: false properties: archived_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer pending claim replaced this row; `null` if this is the current pending row. examples: - '2026-07-20T08:15:00Z' title: Archived At claim_type: const: relationships title: Claim Type created_at: description: Date and time the claim was created. examples: - '2026-07-14T09:30:00Z' format: date-time title: Created At type: string id: description: Unique resource identifier. title: Id type: string lifecycle: description: >- Derived lifecycle role from `status`, `archived_at`, and `superseded_at`. enum: - active - in_flight - historical readOnly: true title: Lifecycle type: string person: description: ID of the person this claim belongs to. title: Person type: string relationships: items: $ref: '#/components/schemas/RelationshipEntry-Output' minItems: 1 title: Relationships type: array status: description: >- Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row. enum: - pending - verified title: Status type: string superseded_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer verified claim replaced this row; `null` if this is the current row. examples: - '2026-08-01T12:00:00Z' title: Superseded At verified_at: anyOf: - format: date-time type: string - type: 'null' description: Date and time the claim was verified; `null` while pending. examples: - '2026-07-14T10:00:00Z' title: Verified At required: - claim_type - relationships - id - person - created_at - status - verified_at - superseded_at - archived_at - lifecycle title: RelationshipsPersonClaim type: object ResidencePersonClaim: additionalProperties: false properties: archived_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer pending claim replaced this row; `null` if this is the current pending row. examples: - '2026-07-20T08:15:00Z' title: Archived At city: title: City type: string claim_type: const: residence title: Claim Type country_code: title: Country Code type: string created_at: description: Date and time the claim was created. examples: - '2026-07-14T09:30:00Z' format: date-time title: Created At type: string district_county: anyOf: - type: string - type: 'null' title: District County id: description: Unique resource identifier. title: Id type: string lifecycle: description: >- Derived lifecycle role from `status`, `archived_at`, and `superseded_at`. enum: - active - in_flight - historical readOnly: true title: Lifecycle type: string line1: title: Line1 type: string line2: anyOf: - type: string - type: 'null' title: Line2 line3: anyOf: - type: string - type: 'null' title: Line3 person: description: ID of the person this claim belongs to. title: Person type: string postal_code: title: Postal Code type: string status: description: >- Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row. enum: - pending - verified title: Status type: string superseded_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer verified claim replaced this row; `null` if this is the current row. examples: - '2026-08-01T12:00:00Z' title: Superseded At verified_at: anyOf: - format: date-time type: string - type: 'null' description: Date and time the claim was verified; `null` while pending. examples: - '2026-07-14T10:00:00Z' title: Verified At required: - line1 - postal_code - city - country_code - claim_type - id - person - created_at - status - verified_at - superseded_at - archived_at - lifecycle title: ResidencePersonClaim type: object TaxResidenciesPersonClaim: additionalProperties: false properties: archived_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer pending claim replaced this row; `null` if this is the current pending row. examples: - '2026-07-20T08:15:00Z' title: Archived At claim_type: const: tax_residencies title: Claim Type created_at: description: Date and time the claim was created. examples: - '2026-07-14T09:30:00Z' format: date-time title: Created At type: string id: description: Unique resource identifier. title: Id type: string lifecycle: description: >- Derived lifecycle role from `status`, `archived_at`, and `superseded_at`. enum: - active - in_flight - historical readOnly: true title: Lifecycle type: string person: description: ID of the person this claim belongs to. title: Person type: string status: description: >- Claim status (`pending` or `verified`). Non-null `superseded_at` means a newer verified claim replaced this row. enum: - pending - verified title: Status type: string superseded_at: anyOf: - format: date-time type: string - type: 'null' description: >- Date and time a newer verified claim replaced this row; `null` if this is the current row. examples: - '2026-08-01T12:00:00Z' title: Superseded At tax_residencies: items: $ref: '#/components/schemas/TaxResidencyEntry' title: Tax Residencies type: array verified_at: anyOf: - format: date-time type: string - type: 'null' description: Date and time the claim was verified; `null` while pending. examples: - '2026-07-14T10:00:00Z' title: Verified At required: - claim_type - id - person - created_at - status - verified_at - superseded_at - archived_at - lifecycle title: TaxResidenciesPersonClaim type: object Error: properties: code: description: A machine-readable error code. title: Code type: string context: additionalProperties: anyOf: - type: string - type: integer description: An optional object for adding extra context to the error. title: Context type: object x-remove-null-from-type-union: true detail: description: A human-readable description of the error. title: Detail type: string docs: description: A URL to documentation about this error code. title: Docs type: string x-remove-null-from-type-union: true params: description: An optional list of params that failed validation. items: $ref: '#/components/schemas/InvalidParam' title: Params type: array x-remove-null-from-type-union: true required: - detail - code title: Error type: object EurAmountBand: enum: - lt_50k - 50k_100k - 100k_250k - 250k_500k - 500k_1m - 1m_3m - gt_3m properties: {} title: EurAmountBand type: string ClaimIndustry: enum: - accountancy - admin_secretarial - agricultural - arms_trade - catering_hospitality - company_services - consulting - creative_media - defence_military - education - emergency_services - energy - export_import - financial_services - gambling - government_public_sector - health_medical - legal - leisure_entertainment_tourism - manufacturing - marketing_pr_advertising - ngo - nonprofit_charity - oil_gas_mining - pharmaceuticals - precious_metals_stones - professional_services - property_construction_trade - retail - social_care_services - technology - telecommunications - transport_logistics - adult_entertainment - cannabis_cbd - cryptocurrencies - embassy_consulate - other properties: {} title: ClaimIndustry type: string ClaimEducationLevel: enum: - none - secondary - bachelors - masters - doctorate - professional properties: {} title: ClaimEducationLevel type: string ClaimEmploymentStatus: enum: - employed - self_employed - retired - student - unemployed properties: {} title: ClaimEmploymentStatus type: string ClaimIncomeSource: enum: - salary - pension - rental_income - dividends - interest properties: {} title: ClaimIncomeSource type: string ClaimWealthSource: enum: - savings - inheritance - trust_fund - investments - borrowings - real_estate properties: {} title: ClaimWealthSource type: string ClaimAssetClass: enum: - treasury_bills - bonds - equities - etfs - mutual_funds - fx - cfds - derivatives - crypto properties: {} title: ClaimAssetClass type: string NationalityEntry: additionalProperties: false properties: basis: anyOf: - $ref: '#/components/schemas/NationalityBasis' - type: 'null' country_code: title: Country Code type: string required: - country_code title: NationalityEntry type: object ClaimRegistrationEntityType: enum: - private_company - public_company - listed_company - investment_firm - pension_provident_fund - investment_fund - insurance_firm - trust - partnership - bank_emi properties: {} title: ClaimRegistrationEntityType type: string RelationshipEntry-Output: additionalProperties: false description: A single relationship entry within a relationships claim. properties: appointment_date: anyOf: - format: date type: string - type: 'null' title: Appointment Date authority_scope: anyOf: - type: string - type: 'null' title: Authority Scope control_type: anyOf: - $ref: '#/components/schemas/ControlType' - type: 'null' end_date: anyOf: - format: date type: string - type: 'null' title: End Date ownership_percentage: anyOf: - type: string - type: 'null' title: Ownership Percentage position: anyOf: - type: string - type: 'null' title: Position related_person: title: Related Person type: string relationship_type: $ref: '#/components/schemas/PersonRelationshipType' required: - related_person - relationship_type title: RelationshipEntry type: object TaxResidencyEntry: additionalProperties: false properties: country_code: title: Country Code type: string tin: anyOf: - type: string - type: 'null' title: Tin tin_exemption_reason: anyOf: - $ref: '#/components/schemas/TinExemptionReason' - type: 'null' required: - country_code title: TaxResidencyEntry type: object InvalidParam: properties: code: description: A machine-readable error code. title: Code type: string detail: description: Human-readable detail for error. title: Detail type: string path: description: Path to the field name (or index if a list) that errored. items: anyOf: - type: integer - type: string title: Path type: array required: - path - detail - code title: InvalidParam type: object NationalityBasis: enum: - birth - naturalisation - descent - marriage - investment_programme - other properties: {} title: NationalityBasis type: string ControlType: enum: - ownership - voting - other properties: {} title: ControlType type: string PersonRelationshipType: enum: - director - shareholder - beneficial_owner - trustee - settlor - authorised_signatory - senior_management properties: {} title: PersonRelationshipType type: string TinExemptionReason: enum: - not_issued - pending_application - not_required properties: {} title: TinExemptionReason type: string securitySchemes: HTTPBearer: scheme: bearer type: http ````