> ## Documentation Index
> Fetch the complete documentation index at: https://docs.altss.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Relationship data
> A relationship connects distinct subjects through a specific recorded role or an explicitly labeled contextual evidence candidate.
## Overview
A relationship connects distinct subjects through a specific recorded role or an explicitly labeled contextual evidence candidate.
## Field groups
* Connection
## Field reference
SOURCE\_DEPENDENT describes availability; access is a separate product/rights boundary. Null means unknown, not false or zero.
| Field | Type | Availability | Access | Description |
| ----------------------------------------------------- | ------------- | ----------------- | ---------------------- | ----------------------------------------------------------------------------------------------- |
| Subject (relationship.subject) | string · 0..1 | SOURCE\_DEPENDENT | SELECTED\_INTELLIGENCE | The organization or person at the starting end of a recorded connection. |
| Relationship type (relationship.predicate) | string · 0..1 | SOURCE\_DEPENDENT | SELECTED\_INTELLIGENCE | The recorded semantic connection, such as employment, investment, ownership or manager context. |
| Object (relationship.object) | string · 0..1 | SOURCE\_DEPENDENT | SELECTED\_INTELLIGENCE | The distinct organization or person at the other end of the connection. |
| Context class (relationship.context\_class) | string · 0..1 | SOURCE\_DEPENDENT | SELECTED\_INTELLIGENCE | Recorded relationship or separately presented evidence candidate. |
| Observed date (relationship.observed\_date) | string · 0..1 | SOURCE\_DEPENDENT | SELECTED\_INTELLIGENCE | Observation time where exposed on the supporting connection or evidence candidate. |
| Supporting context (relationship.supporting\_context) | string · 0..1 | SOURCE\_DEPENDENT | SELECTED\_INTELLIGENCE | An explanation of the supported connection where the view supplies one. |
### Subject
Field ID: `relationship.subject`. Group: Connection.
The organization or person at the starting end of a recorded connection.
**Evidence / dates:** Use only the source or event date actually recorded; record modification is not verification.
**Limitation:** Subject identity must be established separately; a similar name is insufficient.
### Relationship type
Field ID: `relationship.predicate`. Group: Connection.
The recorded semantic connection, such as employment, investment, ownership or manager context.
**Evidence / dates:** Use only the source or event date actually recorded; record modification is not verification.
**Limitation:** Retain the actual source-supported type. Do not infer ownership from employment or a personal relationship from co-investment.
### Object
Field ID: `relationship.object`. Group: Connection.
The distinct organization or person at the other end of the connection.
**Evidence / dates:** Use only the source or event date actually recorded; record modification is not verification.
**Limitation:** A relationship does not merge subject and object into one entity.
### Context class
Field ID: `relationship.context_class`. Group: Connection.
Recorded relationship or separately presented evidence candidate.
Defined values: `recorded_relationship`, `evidence_candidate`; null when unknown.
**Evidence / dates:** Use only the source or event date actually recorded; record modification is not verification.
**Limitation:** An evidence candidate is a research lead, not a verified identity, personal relationship or guaranteed warm path.
### Observed date
Field ID: `relationship.observed_date`. Group: Connection.
Observation time where exposed on the supporting connection or evidence candidate.
**Evidence / dates:** Use only the source or event date actually recorded; record modification is not verification.
**Limitation:** May be absent. No complete relationship history or general valid-from/valid-to guarantee.
### Supporting context
Field ID: `relationship.supporting_context`. Group: Connection.
An explanation of the supported connection where the view supplies one.
**Evidence / dates:** Use only the source or event date actually recorded; record modification is not verification.
**Limitation:** Public or governed source rights apply. A citation URL is not exposed for every connection; customer-private notes are a separate workflow category.
## Relationships to other entities
Read subject → predicate → object. Examples include recorded employment, investment, ownership, manager, portfolio and transaction-participant context, only where the particular source supports that type.
Publicly observed evidence and governed source information retain their disclosure rights. A source URL or observation date is not exposed on every connection.
A related-by-evidence candidate is a research lead. Inferred connections are not included as an offered field state in this reference.
Customer-private meetings, notes and inbox/interaction context belong to an authorized Capital workflow. They are separate from these entity fields and are not merged into the public catalog.
## relationship-context
Fictional request brief, entities, sources, values and dates. This is a documentation example, not a live HTTP response or customer result. Missing dates remain null.
**Current availability:** Reviewed bounded request. **Execution:** Manual / scoped. **Automated invocation:** Not currently available. **API endpoint:** None. **MCP execution:** None.
A research brief for human scope review, not an API payload.
```json theme={null}
{
"organization": "Example Capital",
"objective": "A sourced professional role and a separately supplied fictional customer note give context for the customer to review before deciding whether to approach.",
"intended_use": "Research preparation"
}
```
```json theme={null}
{
"task_type": "organization-research",
"status": "supported_with_unknowns",
"entity": null,
"subject": {
"entity_type": "organization",
"name": "Example Capital",
"website": "https://example.com/fictional/organization",
"research_scope": null
},
"as_of": null,
"result": {
"summary": "A sourced professional role and a separately supplied fictional customer note give context for the customer to review before deciding whether to approach.",
"company": null,
"criteria": [],
"sections": [
{
"entity_type": "relationship",
"data": {
"subject": "Morgan Lee",
"predicate": "employment",
"object": "Example Capital",
"context_class": "recorded_relationship",
"observed_date": null,
"supporting_context": "Fictional organization team page names Morgan Lee as Investment Director."
}
}
],
"customer_context": [
{
"visibility": "customer_private",
"source_type": "customer_provided",
"summary": "Fictional customer note: a colleague recorded a sector discussion with the target person.",
"limitation": "Separate authorized customer context; not public graph evidence or proof of current interest."
}
]
},
"evidence": [
{
"field": "result.sections.0.data.subject",
"source_url": "https://example.com/fictional/organization/source",
"source_type": "official_website",
"published_at": "2026-09-12T09:30:00Z",
"captured_at": null,
"observed_at": null,
"verified_at": null,
"basis": "The fictional source supplies this subject entry. It does not establish current appetite or verification."
},
{
"field": "result.sections.0.data.predicate",
"source_url": "https://example.com/fictional/organization/source",
"source_type": "official_website",
"published_at": "2026-09-12T09:30:00Z",
"captured_at": null,
"observed_at": null,
"verified_at": null,
"basis": "The fictional source supplies this predicate entry. It does not establish current appetite or verification."
},
{
"field": "result.sections.0.data.object",
"source_url": "https://example.com/fictional/organization/source",
"source_type": "official_website",
"published_at": "2026-09-12T09:30:00Z",
"captured_at": null,
"observed_at": null,
"verified_at": null,
"basis": "The fictional source supplies this object entry. It does not establish current appetite or verification."
},
{
"field": "result.sections.0.data.context_class",
"source_url": "https://example.com/fictional/organization/source",
"source_type": "official_website",
"published_at": "2026-09-12T09:30:00Z",
"captured_at": null,
"observed_at": null,
"verified_at": null,
"basis": "The fictional source supplies this context class entry. It does not establish current appetite or verification."
},
{
"field": "result.sections.0.data.supporting_context",
"source_url": "https://example.com/fictional/organization/source",
"source_type": "official_website",
"published_at": "2026-09-12T09:30:00Z",
"captured_at": null,
"observed_at": null,
"verified_at": null,
"basis": "The fictional source supplies this supporting context entry. It does not establish current appetite or verification."
},
{
"field": "result.customer_context.0",
"source_url": null,
"source_type": "customer_provided",
"published_at": null,
"captured_at": null,
"observed_at": null,
"verified_at": null,
"basis": "Fictional note supplied by the customer. It supports only the recorded interaction context, not a public role or investment mandate."
}
],
"unknowns": [
"Current interest in a conversation",
"Date of the private interaction"
],
"limitations": [
"Every entity, source, date and value in this example is fictional. No real customer result or live task execution is shown.",
"Available facts and result use remain subject to source rights, the agreed purpose and manual review."
],
"rights": {
"scope": "A task purchases the agreed bounded result, not database access, unrestricted API queries, contacts export or graph redistribution. Sources and unknowns accompany results. Purchaser authorization, scope acceptance, agreement and payment are required before manual fulfillment; no automated external task service is offered.",
"raw_graph_access": false,
"bulk_export": false,
"graph_redistribution": false
}
}
```
Each field path identifies the particular value supported by the source note.
| Field path | Illustrated value | Source type | Basis |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| result.sections.0.data.subject | "Morgan Lee" | official\_website | The fictional source supplies this subject entry. It does not establish current appetite or verification. |
| result.sections.0.data.predicate | "employment" | official\_website | The fictional source supplies this predicate entry. It does not establish current appetite or verification. |
| result.sections.0.data.object | "Example Capital" | official\_website | The fictional source supplies this object entry. It does not establish current appetite or verification. |
| result.sections.0.data.context\_class | "recorded\_relationship" | official\_website | The fictional source supplies this context class entry. It does not establish current appetite or verification. |
| result.sections.0.data.supporting\_context | "Fictional organization team page names Morgan Lee as Investment Director." | official\_website | The fictional source supplies this supporting context entry. It does not establish current appetite or verification. |
| result.customer\_context.0 | \{"visibility":"customer\_private","source\_type":"customer\_provided","summary":"Fictional customer note: a colleague recorded a sector discussion with the target person.","limitation":"Separate authorized customer context; not public graph evidence or proof of current interest."} | customer\_provided | Fictional note supplied by the customer. It supports only the recorded interaction context, not a public role or investment mandate. |
```json theme={null}
[
{
"field": "result.sections.0.data.subject",
"source_url": "https://example.com/fictional/organization/source",
"source_type": "official_website",
"published_at": "2026-09-12T09:30:00Z",
"captured_at": null,
"observed_at": null,
"verified_at": null,
"basis": "The fictional source supplies this subject entry. It does not establish current appetite or verification."
},
{
"field": "result.sections.0.data.predicate",
"source_url": "https://example.com/fictional/organization/source",
"source_type": "official_website",
"published_at": "2026-09-12T09:30:00Z",
"captured_at": null,
"observed_at": null,
"verified_at": null,
"basis": "The fictional source supplies this predicate entry. It does not establish current appetite or verification."
},
{
"field": "result.sections.0.data.object",
"source_url": "https://example.com/fictional/organization/source",
"source_type": "official_website",
"published_at": "2026-09-12T09:30:00Z",
"captured_at": null,
"observed_at": null,
"verified_at": null,
"basis": "The fictional source supplies this object entry. It does not establish current appetite or verification."
},
{
"field": "result.sections.0.data.context_class",
"source_url": "https://example.com/fictional/organization/source",
"source_type": "official_website",
"published_at": "2026-09-12T09:30:00Z",
"captured_at": null,
"observed_at": null,
"verified_at": null,
"basis": "The fictional source supplies this context class entry. It does not establish current appetite or verification."
},
{
"field": "result.sections.0.data.supporting_context",
"source_url": "https://example.com/fictional/organization/source",
"source_type": "official_website",
"published_at": "2026-09-12T09:30:00Z",
"captured_at": null,
"observed_at": null,
"verified_at": null,
"basis": "The fictional source supplies this supporting context entry. It does not establish current appetite or verification."
},
{
"field": "result.customer_context.0",
"source_url": null,
"source_type": "customer_provided",
"published_at": null,
"captured_at": null,
"observed_at": null,
"verified_at": null,
"basis": "Fictional note supplied by the customer. It supports only the recorded interaction context, not a public role or investment mandate."
}
]
```
## Evidence / dates
Supporting evidence attaches to a specific field. Missing publication, capture, observation and verification dates remain unknown. Subscription views do not expose every source URL or date. [Read evidence and date semantics](/evidence-and-dates).
## What may be unknown
No calibrated relationship score, probability of introduction or brokered introduction is promised. Shared events, names or fund participation do not establish personal access or investor interest.
Generic valid\_from / valid\_to fields and complete relationship validity histories are not included in this reference. Recorded employment dates remain a separate People concept.
## Access & rights
Access scope: SELECTED\_INTELLIGENCE. Field descriptions are public; premium records remain permissioned.
A task purchases the agreed bounded result, not database access, unrestricted API queries, contacts export or graph redistribution. Sources and unknowns accompany results. Purchaser authorization, scope acceptance, agreement and payment are required before manual fulfillment; no automated external task service is offered.
## Related tasks
* [Research template](/tasks/relationship-context-research)
* [Entity JSON Schema](https://altss.com/schemas/relationship.json)
* [Access and rights](/access-and-rights)