v2
latestOpenAPI 3.1.02026-07-263155112.9 KBentity-grid
Get generic entity grid with configurable associations
Returns a generic entity × entity grid with configurable association categories.
This endpoint allows you to specify:
- **column_association_category**: One or more association categories for the
context → column hop (e.g., causal gene-disease, correlated gene-disease)
- **row_association_category**: The association category for the column → row hop
- **row_grouping**: How to group rows (histopheno for body systems, or none)
- **group_columns_by_category**: Whether to sort columns by their source association
Example: To get a grid of diseases (causal + correlated) and their phenotypes for a gene:
```
GET /entity-grid/HGNC:4851?column_association_category=biolink:CausalGeneToDiseaseAssociation
&column_association_category=biolink:CorrelatedGeneToDiseaseAssociation
&row_association_category=biolink:DiseaseToPhenotypicFeatureAssociation
&group_columns_by_category=true
```
The response includes source_association_category on each column entity,
allowing the frontend to display different column groups.
get/v3/api/entity-grid/{context_id}
Path parameters
context_idstring required
Context entity ID (gene, disease, etc.)
Example:HGNC:4851
Context entity ID (gene, disease, etc.)
Query parameters
column_association_categoryAssociationCategory[] required
Association category/categories for context → column
Association category/categories for context → column
row_association_categoryAssociationCategory[] required
Association category/categories for column → row
Association category/categories for column → row
row_grouping'histopheno' | 'none'
Row grouping options.
How to group rows
group_columns_by_categoryboolean
Sort columns by association category
Sort columns by association category
directboolean
Only include direct associations (not via closure)
Only include direct associations (not via closure)
limitinteger
Maximum number of column entities
Maximum number of column entities
Response
Successful Response