--- title: "Association Table" method: GET path: "/v3/api/entity/{id}/{category}" tags: ["entity"] --- # Association Table `GET /v3/api/entity/{id}/{category}` Retrieves association table data for a given entity and association type Args:
id (str): ID of the entity to retrieve association table data, ex: MONDO:0019391
category (str): Category of association to retrieve association table data for, ex: biolink:DiseaseToPhenotypicFeatureAssociation
Path (str, optional): Path string to limit results to a subset. Defaults to None.
pagination (PaginationParams, optional): Pagination parameters. Defaults to Depends().
Returns:
AssociationResults: Association table data for the specified entity and association type ## Path parameters - `id` string, required - `category` 'biolink:PairwiseGeneToGeneInteraction' | 'biolink:GeneToExpressionSiteAssociation' | 'biolink:GeneToGeneHomologyAssociation' | 'biolink:Association' | 'biolink:MacromolecularMachineToBiologicalProcessAssociation' | 'biolink:MacromolecularMachineToMolecularActivityAssociation' | 'biolink:MacromolecularMachineToCellularComponentAssociation' | 'biolink:GeneToPhenotypicFeatureAssociation' | 'biolink:GenotypeToPhenotypicFeatureAssociation' | 'biolink:VariantToPhenotypicFeatureAssociation' | 'biolink:DiseaseToPhenotypicFeatureAssociation' | 'biolink:GeneToPathwayAssociation' | 'biolink:VariantToGeneAssociation' | 'biolink:CaseToPhenotypicFeatureAssociation' | 'biolink:GenotypeToGeneAssociation' | 'biolink:GenotypeToVariantAssociation' | 'biolink:ChemicalEntityToPathwayAssociation' | 'biolink:VariantToDiseaseAssociation' | 'biolink:ChemicalEntityToDiseaseOrPhenotypicFeatureAssociation' | 'biolink:GenotypeToDiseaseAssociation' | 'biolink:DiseaseOrPhenotypicFeatureToGeneticInheritanceAssociation' | 'biolink:CorrelatedGeneToDiseaseAssociation' | 'biolink:CaseToDiseaseAssociation' | 'biolink:CaseToGeneAssociation' | 'biolink:CausalGeneToDiseaseAssociation' | 'biolink:DiseaseOrPhenotypicFeatureToLocationAssociation' | 'biolink:ChemicalOrDrugOrTreatmentToDiseaseOrPhenotypicFeatureAssociation', required — Association categories ## Query parameters - `query` string - `traverse_orthologs` boolean - `sort` string[] - `format` 'json' | 'tsv' - `download` boolean - `direct` boolean - `facet_fields` string[] - `facet_queries` string[] - `filter_queries` string[] - `limit` integer - `offset` integer ## Response `200` Successful Response - union - AssociationTableResults - `limit` integer, required — number of items to return in a response - `offset` integer, required — offset into the total number of items - `total` integer, required — total number of items matching a query - `items` DirectionalAssociation[], required — A collection of items, with the type to be overriden by slot_usage - `id` string, required - `predicate` string, required - `category` string, nullable - `agent_type` string, required — Describes the high-level category of agent who originally generated a statement of knowledge or other type of information. - `aggregator_knowledge_source` string[], nullable - `knowledge_level` string, required — Describes the level of knowledge expressed in a statement, based on the reasoning or analysis methods used to generate the statement, or the scope or specificity of what the statement expresses to be true. - `original_predicate` string, nullable — used to hold the original relation/predicate that an external knowledge source uses before transformation to match the biolink-model specification. - `primary_knowledge_source` string, nullable - `file_source` string, nullable — Source file stem injected by koza at load time. - `provided_by` string, nullable - `has_evidence` string[], nullable - `publications` string[], nullable - `qualifiers` string[], nullable - `negated` boolean, nullable - `FDA_adverse_event_level` string, nullable — The level of FDA adverse event reporting for a drug-condition association. - `disease_context_qualifier` string, nullable — A context qualifier representing a disease or condition in which a relationship expressed in an association took place. - `frequency_qualifier` string, nullable - `has_count` integer, nullable — count of out of has_total representing a frequency - `has_percentage` number, nullable — percentage, which may be calculated from has_count and has_total, as 100 * quotient or provided directly, rounded to the integer level - `has_quotient` number, nullable — quotient, which should be 1/100 of has_percentage - `has_total` integer, nullable — total, devided by has_count, representing a frequency - `onset_qualifier` string, nullable - `sex_qualifier` string, nullable - `has_attribute` string[], nullable - `object_aspect_qualifier` string, nullable — Composes with the core concept (+ qualifier) to describe new concepts of a more specific kind. The aspect qualifier represents an attribute of the object that is the focus of the relationship (e.g. for an association where the object is a gene, this might be the expression, abundance, activity, or stability of the gene). - `species_context_qualifier` string, nullable — A context qualifier representing a species in which a relationship expressed in an association took place. - `stage_qualifier` string, nullable - `qualifier` string, nullable - `object_specialization_qualifier` string, nullable — A qualifier that composes with a core subject/object concept to define a more specific version of the object concept, specifically using an ontology term that is not a subclass or descendant of the core concept and in the vast majority of cases, is of a different ontological namespace than the category or namespace of the object identifier. - `subject` string, required - `object` string, required - `original_subject` string, nullable - `original_object` string, nullable - `evidence_count` integer, nullable — count of supporting documents, evidence codes, and sources supplying evidence - `grouping_key` string, nullable — A concatenation of fields used to group associations with the same essential/defining properties - `subject_label` string, nullable — The name of the subject entity - `subject_category` string, nullable — The category of the subject entity - `subject_namespace` string, nullable — The namespace/prefix of the subject entity - `subject_closure` string[], nullable — Field containing subject id and the ids of all of it's ancestors - `subject_closure_label` string[], nullable — Field containing subject name and the names of all of it's ancestors - `subject_taxon` string, nullable - `subject_taxon_label` string, nullable - `object_label` string, nullable — The name of the object entity - `object_category` string, nullable — The category of the object entity - `object_namespace` string, nullable — The namespace/prefix of the object entity - `object_closure` string[], nullable — Field containing object id and the ids of all of it's ancestors - `object_closure_label` string[], nullable — Field containing object name and the names of all of it's ancestors - `object_taxon` string, nullable - `object_taxon_label` string, nullable - `disease_context_qualifier_label` string, nullable — The name of the disease_context_qualifier entity - `disease_context_qualifier_category` string, nullable — The category of the disease_context_qualifier entity - `disease_context_qualifier_namespace` string, nullable — The namespace/prefix of the disease_context_qualifier entity - `disease_context_qualifier_closure` string[], nullable — Field containing disease_context_qualifier id and the ids of all of it's ancestors - `disease_context_qualifier_closure_label` string[], nullable — Field containing disease_context_qualifier name and the names of all of it's ancestors - `species_context_qualifier_label` string, nullable — The name of the species_context_qualifier entity - `species_context_qualifier_category` string, nullable — The category of the species_context_qualifier entity - `species_context_qualifier_namespace` string, nullable — The namespace/prefix of the species_context_qualifier entity - `stage_qualifier_label` string, nullable — The name of the stage_qualifier entity - `stage_qualifier_category` string, nullable — The category of the stage_qualifier entity - `stage_qualifier_namespace` string, nullable — The namespace/prefix of the stage_qualifier entity - `sex_qualifier_label` string, nullable — The name of the sex_qualifier entity - `sex_qualifier_category` string, nullable — The category of the sex_qualifier entity - `sex_qualifier_namespace` string, nullable — The namespace/prefix of the sex_qualifier entity - `onset_qualifier_label` string, nullable — The name of the onset_qualifier entity - `onset_qualifier_category` string, nullable — The category of the onset_qualifier entity - `onset_qualifier_namespace` string, nullable — The namespace/prefix of the onset_qualifier entity - `frequency_qualifier_label` string, nullable — The name of the frequency_qualifier entity - `frequency_qualifier_category` string, nullable — The category of the frequency_qualifier entity - `frequency_qualifier_namespace` string, nullable — The namespace/prefix of the frequency_qualifier entity - `provided_by_link` ExpandedCurie — A curie bundled along with its expanded url - `id` string, required - `url` string, nullable - `has_evidence_links` ExpandedCurie[], nullable — List of ExpandedCuries with id and url for evidence - `id` string, required - `url` string, nullable - `publications_links` ExpandedCurie[], nullable — List of ExpandedCuries with id and url for publications - `id` string, required - `url` string, nullable - `supporting_text` string[], nullable — The text in a publication that supports the assertion in the association. - `highlighting` AssociationHighlighting — Optional highlighting information for search results - `object_label` string[], nullable — The name of the object entity - `object_closure_label` string[], nullable — Field containing object name and the names of all of it's ancestors - `subject_label` string[], nullable — The name of the subject entity - `subject_closure_label` string[], nullable — Field containing subject name and the names of all of it's ancestors - `predicate` string[], nullable - `direction` 'incoming' | 'outgoing', required — The directionality of an association as it relates to a specified entity, with edges being categorized as incoming or outgoing - `facet_fields` FacetField[], nullable — Collection of facet field responses with the field values and counts - `label` string, required - `facet_values` FacetValue[], nullable — Collection of FacetValue label/value instances belonging to a FacetField - `label` string, required - `count` integer, nullable — count of documents - `facet_queries` FacetValue[], nullable — Collection of facet query responses with the query string values and counts - `label` string, required - `count` integer, nullable — count of documents - string ## Other responses - `404` — Not Found - `422` — Validation Error ## Changes - **2026-08-26** `2ceb106a8c03` — 1 warning - removed the optional property `anyOf[subschema #1: AssociationTableResults]/items/items/sources` from the response with the `200` status - **2026-07-26** `1dd6862950fc` — 1 info - added the optional property `anyOf[subschema #1: AssociationTableResults]/items/items/sources` to the response with the `200` status [Change history](https://skmtc.dev/monarchinitiative/apis/fastapi/changes/v3/api/entity/:id/:category/get.md) --- [API](https://skmtc.dev/monarchinitiative/apis/fastapi.md) · [All operations](https://skmtc.dev/monarchinitiative/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/monarchinitiative/fastapi/revisions/2ceb106a8c03/schema)