--- title: "Association Table" method: GET path: "/v3/api/entity/{id}/{category}" tags: ["entity"] --- # Association Table `GET /v3/api/entity/{id}/{category}` ## Request - Base URL: `https://monarchinitiative.org` (the document declares no server; this is the origin it was published from) - URL: `https://monarchinitiative.org/v3/api/entity/{id}/{category}` - Auth: none declared 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` string, required ## 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. - `primary_knowledge_source` string, nullable - `file_source` string, nullable: Source file stem injected by koza at load time. - `provided_by` string, nullable - `publications` string[], nullable - `qualifiers` string[], nullable - `has_evidence` string[], nullable - `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 - `negated` boolean, nullable - `onset_qualifier` string, nullable - `sex_qualifier` string, nullable - `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. - `disease_context_qualifier` string, nullable: A context qualifier representing a disease or condition in which a relationship expressed in an association took place. - `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). - `FDA_adverse_event_level` string, nullable: The level of FDA adverse event reporting for a drug-condition association. - `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-09-26** `00871419e83e`: 27 breaking - removed the enum value `biolink:Association` from the `path` request parameter `category` - removed the enum value `biolink:CaseToDiseaseAssociation` from the `path` request parameter `category` - removed the enum value `biolink:CaseToGeneAssociation` from the `path` request parameter `category` - removed the enum value `biolink:CaseToPhenotypicFeatureAssociation` from the `path` request parameter `category` - …23 more - **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 [Operation history](https://skmtc.dev/monarchinitiative/apis/monarchinitiative-api/changes/v3/api/entity/:id/:category/get.md) --- [API](https://skmtc.dev/monarchinitiative/apis/monarchinitiative-api.md) - [All operations](https://skmtc.dev/monarchinitiative/apis/monarchinitiative-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monarchinitiative/apis/monarchinitiative-api/revisions/00871419e83e?raw)