Skip to main content
  • Sync
  • Async
def get_graph(name: str) -> Graph

​
Parameters

  • name (str): Name of the graph to retrieve

​
Returns

  • Graph: The requested graph object. If the graph is still building it will have system_metadata["status"] == "processing". Use the convenience helpers graph.is_processing, graph.is_completed, graph.error, or the client-level wait_for_graph_completion() to monitor progress.

​
Examples

  • Sync
  • Async
from morphik import Morphik

db = Morphik()

# Get a graph by name
graph = db.get_graph("finance_graph")

if graph.is_processing:
    print("Graph still processing, waiting...")
    graph = db.wait_for_graph_completion("finance_graph")

# Now safe to access entities and relationships
print(f"Graph has {len(graph.entities)} entities and {len(graph.relationships)} relationships")

# Access entities and relationships
for entity in graph.entities:
    print(f"Entity: {entity.label} ({entity.type})")

for relationship in graph.relationships:
    source_entity = next((e for e in graph.entities if e.id == relationship.source_id), None)
    target_entity = next((e for e in graph.entities if e.id == relationship.target_id), None)
    if source_entity and target_entity:
        print(f"Relationship: {source_entity.label} --{relationship.type}--> {target_entity.label}")

​
Graph Properties

The returned Graph object has the following properties:
  • id (str): Unique graph identifier
  • name (str): Graph name
  • entities (List[Entity]): List of entities in the graph
  • relationships (List[Relationship]): List of relationships in the graph
  • metadata (Dict[str, Any]): Graph metadata
  • document_ids (List[str]): Source document IDs
  • filters (Dict[str, Any], optional): Document filters used to create the graph
  • created_at (datetime): Creation timestamp
  • updated_at (datetime): Last update timestamp
  • owner (Dict[str, str]): Graph owner information

​
Entity Properties

Each Entity object has the following properties:
  • id (str): Unique entity identifier
  • label (str): Display label for the entity
  • type (str): Entity type
  • properties (Dict[str, Any]): Entity properties
  • document_ids (List[str]): Source document IDs
  • chunk_sources (Dict[str, List[int]]): Source chunk numbers by document ID

​
Relationship Properties

Each Relationship object has the following properties:
  • id (str): Unique relationship identifier
  • source_id (str): Source entity ID
  • target_id (str): Target entity ID
  • type (str): Relationship type
  • document_ids (List[str]): Source document IDs
  • chunk_sources (Dict[str, List[int]]): Source chunk numbers by document ID