--- title: "Get Associations" method: GET path: "/v3/api/association" tags: ["association"] --- # Get Associations `GET /v3/api/association` Retrieves all associations for a given entity, or between two entities. ## Query parameters - `category` AssociationCategory[] - `subject` string[], nullable - `subject_category` EntityCategory[] - `subject_namespace` string[], nullable - `subject_taxon` string[], nullable - `predicate` AssociationPredicate[] - `object` string[], nullable - `object_category` EntityCategory[] - `object_namespace` string[], nullable - `object_taxon` string[], nullable - `entity` string[], nullable - `primary_knowledge_source` string[], nullable - `direct` boolean - `facet_fields` string[] - `facet_queries` string[] - `filter_queries` string[] - `compact` boolean - `query` string, nullable — Search query to filter associations - `format` 'json' | 'tsv' - `limit` integer - `offset` integer ## Response `200` Successful Response - union - AssociationResults - `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` ExpandedAssociation[], 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 - `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 - CompactAssociationResults - `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` CompactAssociation[], required — A collection of items, with the type to be overriden by slot_usage - `category` string, nullable - `subject` string, required - `subject_label` string, nullable — The name of the subject entity - `predicate` string, required - `object` string, required - `object_label` string, nullable — The name of the object entity - `negated` boolean, nullable - `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 > 3 revisions in range; 1 could not be searched. - **2026-07-26** `1dd6862950fc` — 1 info - added the optional property `anyOf[subschema #1: AssociationResults]/items/items/sources` to the response with the `200` status [Change history](https://skmtc.dev/monarchinitiative/apis/fastapi/changes/v3/api/association/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)