block 2 · online
OCCRP Aleph · dev-docs

Aleph: Records vs Context

Why Aleph is most useful when you need context around records, not just more records.

status
Published
slug
records-vs-context
published
Apr 21, 2026

Aleph: Records vs Context

A common mistake with Aleph is expecting it to behave like a simple registry search tool. It is usually more useful than that — but also less straightforward.

Registry certainty vs contextual depth

A registry-oriented search is often good at answering:

  • what is the legal entity
  • what is the jurisdiction
  • what basic official attributes are visible

Aleph is more helpful when the real question becomes:

  • what else is this entity connected to
  • what documentary context exists around it
  • how does it appear across records and datasets
  • what supporting material can help shape the next step

That is a different job.

Why this distinction matters

If you ask Aleph a clean legal-identity question, it may feel noisy.

If you ask it a contextual question, it often becomes much more useful.

This is why workflow order matters:

  1. confirm the entity
  2. then use Aleph to widen the documentary context
  3. then preserve and interpret carefully

Practical use

Use Aleph when you need a wider documentary field around a target, not when you still have not solved the basic question of who or what the target is.

Why context is harder than records

Records feel clean because they look discrete: a filing, a registry row, a named document. Context is harder because it requires you to decide which surrounding material actually changes the meaning of the case.

Aleph becomes powerful precisely at that boundary. It helps you move from "what is the record?" to "what broader documentary environment surrounds this entity?"

That can include:

  • linked entities
  • repeated document patterns
  • ownership-adjacent context
  • investigative-source material that changes the next research question

Best use in practice

Aleph works best after you already have enough confidence in the subject to recognize which contextual leads are worth following and which are just documentary noise.

last published Apr 21, 2026