Evidence Items

The evidence items endpoint allows users to enumerate all of the evidence items present in CIViC as well as retrieve more detailed information on a specific evidence item. This is the endpoint that should be used to obtain a complete listing of every evidence item in CIViC.

Get a list of evidence items

This endpoint returns a listing of evidence items in CIViC. This index style endpoint is paginated by default. You can use the count and page parameters or the previous and next links to iterate through all the evidence items.

HTTP Request Format

GET https://civicdb.org/api/evidence_items

Query Parameters

Parameter

Default

Description

page

1

Which page of results to return

count

25

How many evidence items to return on a single page

Example Request

curl https://civicdb.org/api/evidence_items?count=1

Example Response

{
    "_meta": {
        "current_page": 1,
        "per_page": "1",
        "total_pages": 7513,
        "total_count": 7513,
        "links": {
            "next": "https://civicdb.org/api/evidence_items?count=1&page=2",
            "previous": null
        }
    },
    "records": [
        {
            "id": 1,
            "name": "EID1",
            "description": "JAK2 V617F is not associated with lymphoid leukemia (B-lineage ALL, T-ALL or CLL).",
            "disease": {
                "id": 1,
                "name": "Lymphoid Leukemia",
                "display_name": "Lymphoid Leukemia",
                "doid": "10747",
                "url": "http://www.disease-ontology.org/?id=DOID:10747"
            },
            "drugs": [],
            "rating": 4,
            "evidence_level": "B",
            "evidence_type": "Diagnostic",
            "clinical_significance": "Negative",
            "evidence_direction": "Supports",
            "variant_origin": "Somatic",
            "drug_interaction_type": null,
            "status": "accepted",
            "open_change_count": 0,
            "type": "evidence",
            "source": {
                "id": 51,
                "name": "The JAK2V617F activating mutation occurs in chronic myelomonocytic leukemia and acute myeloid leukemia, but not in acute lymphoblastic leukemia or chronic lymphocytic leukemia.",
                "citation": "Levine et al., 2005, Blood",
                "citation_id": "16081687",
                "source_type": "PubMed",
                "asco_abstract_id": null,
                "source_url": "http://www.ncbi.nlm.nih.gov/pubmed/16081687",
                "open_access": true,
                "pmc_id": "PMC1895066",
                "publication_date": {
                    "year": 2005,
                    "month": 11,
                    "day": 15
                },
                "journal": "Blood",
                "full_journal_title": "Blood",
                "status": "fully curated",
                "is_review": false,
                "clinical_trials": []
            },
            "variant_id": 64,
            "phenotypes": []
        }
    ]
}

Get details for a specific evidence item

This endpoint retrieves details about a specific evidence item, given its internal CIViC id.

HTTP Request Format

GET https://civicdb.org/api/evidence_items/:id

Example Request

curl https://civicdb.org/api/evidence_items/512

Example Response

{
    "id": 512,
    "name": "EID512",
    "description": "Nonsense mutations in SMARCA4 were associated with small cell carcinoma of the ovary, hypercalcemic type in 10/10 tumor samples, and were rarely found in other solid tumor types catalogued by TCGA.",
    "disease": {
        "id": 253,
        "name": "Small Cell Carcinoma Of The Ovary Hypercalcemic Type",
        "display_name": "Small Cell Carcinoma Of The Ovary Hypercalcemic Type",
        "doid": "7651",
        "url": "http://www.disease-ontology.org/?id=DOID:7651"
    },
    "drugs": [],
    "rating": 5,
    "evidence_level": "B",
    "evidence_type": "Diagnostic",
    "clinical_significance": "Positive",
    "evidence_direction": "Supports",
    "variant_origin": "Somatic",
    "drug_interaction_type": null,
    "status": "accepted",
    "open_change_count": 0,
    "type": "evidence",
    "source": {
        "id": 316,
        "name": "Recurrent SMARCA4 mutations in small cell carcinoma of the ovary.",
        "citation": "Jelinic et al., 2014, Nat. Genet.",
        "citation_id": "24658004",
        "source_type": "PubMed",
        "asco_abstract_id": null,
        "source_url": "http://www.ncbi.nlm.nih.gov/pubmed/24658004",
        "open_access": null,
        "pmc_id": null,
        "publication_date": {
            "year": 2014,
            "month": 5
        },
        "journal": "Nat. Genet.",
        "full_journal_title": "Nature genetics",
        "status": "fully curated",
        "is_review": false,
        "clinical_trials": []
    },
    "variant_id": 217,
    "phenotypes": [],
    "assertions": [],
    "errors": {},
    "lifecycle_actions": {
        "submitted": {
            "timestamp": "2015-08-05T18:47:08.046Z",
            "user": {
                "id": 57,
                "name": "Martin Jones",
                "last_seen_at": "2019-05-24T16:29:42.738Z",
                "username": "MartinJones",
                "role": "editor",
                "avatar_url": "https://secure.gravatar.com/avatar/4fc3a1dc5671917fabd7643ee22e2ee6.png?d=identicon&r=pg&s=32",
                "avatars": {
                    "x128": "https://secure.gravatar.com/avatar/4fc3a1dc5671917fabd7643ee22e2ee6.png?d=identicon&r=pg&s=128",
                    "x64": "https://secure.gravatar.com/avatar/4fc3a1dc5671917fabd7643ee22e2ee6.png?d=identicon&r=pg&s=64",
                    "x32": "https://secure.gravatar.com/avatar/4fc3a1dc5671917fabd7643ee22e2ee6.png?d=identicon&r=pg&s=32",
                    "x14": "https://secure.gravatar.com/avatar/4fc3a1dc5671917fabd7643ee22e2ee6.png?d=identicon&r=pg&s=14"
                },
                "area_of_expertise": "Research Scientist",
                "orcid": "0000-0001-9636-376X",
                "display_name": "MartinJones",
                "created_at": "2015-07-24T21:08:18.535Z",
                "url": "",
                "twitter_handle": "@marvolauk",
                "facebook_profile": "",
                "linkedin_profile": "",
                "bio": "Dr. Jones is a Senior Staff Scientist and Group lead of the Clinical Informatics group at the Canada's Michael Smith Genome Sciences Centre in Vancouver, Canada.  He has an extensive background in molecular biology & functional genomics, specialising in cancer genetics and genomic analysis.  The primary goal of the clinical informatics group is to design and refine approaches for individualised cancer genome analysis and to provide comprehensive integrative genomic analysis of patients tumours. The group is integrated into the BC Cancer agency's Personalized Onco-Genomics (POG)  program, a clinical research initiative that is embedding genomic sequencing into the diagnostic and treatment planning for patients with incurable cancers.",
                "country": {
                    "id": 35,
                    "iso": "CA",
                    "name": "Canada"
                },
                "featured_expert": true,
                "accepted_license": null,
                "signup_complete": null,
                "organizations": [
                    {
                        "id": 3,
                        "name": "BCCA (POGS)",
                        "url": "http://www.bcgsc.ca/project/pog",
                        "description": "The BC Cancer Agency\u2019s Personalized OncoGenomics (POG) program is a clinical research initiative that is embedding genomic sequencing into real-time treatment planning for BC patients with incurable cancers.",
                        "profile_image": {
                            "x256": "/system/organizations/profile_images/000/000/003/x256/bcca-pog-org.png?1592507866",
                            "x128": "/system/organizations/profile_images/000/000/003/x128/bcca-pog-org.png?1592507866",
                            "x64": "/system/organizations/profile_images/000/000/003/x64/bcca-pog-org.png?1592507866",
                            "x32": "/system/organizations/profile_images/000/000/003/x32/bcca-pog-org.png?1592507866",
                            "x14": "/system/organizations/profile_images/000/000/003/x14/bcca-pog-org.png?1592507866"
                        },
                        "parent": {}
                    }
                ],
                "most_recent_organization": {
                    "id": 3,
                    "name": "BCCA (POGS)",
                    "url": "http://www.bcgsc.ca/project/pog",
                    "description": "The BC Cancer Agency\u2019s Personalized OncoGenomics (POG) program is a clinical research initiative that is embedding genomic sequencing into real-time treatment planning for BC patients with incurable cancers.",
                    "profile_image": {
                        "x256": "/system/organizations/profile_images/000/000/003/x256/bcca-pog-org.png?1592507866",
                        "x128": "/system/organizations/profile_images/000/000/003/x128/bcca-pog-org.png?1592507866",
                        "x64": "/system/organizations/profile_images/000/000/003/x64/bcca-pog-org.png?1592507866",
                        "x32": "/system/organizations/profile_images/000/000/003/x32/bcca-pog-org.png?1592507866",
                        "x14": "/system/organizations/profile_images/000/000/003/x14/bcca-pog-org.png?1592507866"
                    },
                    "parent": {}
                },
                "conflict_of_interest": {
                    "coi_valid": "missing",
                    "details": {}
                }
            },
            "organization": {
                "id": 3,
                "name": "BCCA (POGS)",
                "url": "http://www.bcgsc.ca/project/pog",
                "description": "The BC Cancer Agency\u2019s Personalized OncoGenomics (POG) program is a clinical research initiative that is embedding genomic sequencing into real-time treatment planning for BC patients with incurable cancers.",
                "profile_image": {
                    "x256": "/system/organizations/profile_images/000/000/003/x256/bcca-pog-org.png?1592507866",
                    "x128": "/system/organizations/profile_images/000/000/003/x128/bcca-pog-org.png?1592507866",
                    "x64": "/system/organizations/profile_images/000/000/003/x64/bcca-pog-org.png?1592507866",
                    "x32": "/system/organizations/profile_images/000/000/003/x32/bcca-pog-org.png?1592507866",
                    "x14": "/system/organizations/profile_images/000/000/003/x14/bcca-pog-org.png?1592507866"
                },
                "parent": {}
            }
        },
        "accepted": {
            "timestamp": "2015-08-05T18:47:08.046Z",
            "user": {
                "id": 41,
                "name": "Nick Spies",
                "last_seen_at": "2019-01-20T03:51:36.969Z",
                "username": "NickSpies",
                "role": "admin",
                "avatar_url": "https://secure.gravatar.com/avatar/3376aeb8439c5ab3e5d72fa2eeed39e5.png?d=identicon&r=pg&s=32",
                "avatars": {
                    "x128": "https://secure.gravatar.com/avatar/3376aeb8439c5ab3e5d72fa2eeed39e5.png?d=identicon&r=pg&s=128",
                    "x64": "https://secure.gravatar.com/avatar/3376aeb8439c5ab3e5d72fa2eeed39e5.png?d=identicon&r=pg&s=64",
                    "x32": "https://secure.gravatar.com/avatar/3376aeb8439c5ab3e5d72fa2eeed39e5.png?d=identicon&r=pg&s=32",
                    "x14": "https://secure.gravatar.com/avatar/3376aeb8439c5ab3e5d72fa2eeed39e5.png?d=identicon&r=pg&s=14"
                },
                "area_of_expertise": "Research Scientist",
                "orcid": "",
                "display_name": "NickSpies",
                "created_at": "2015-06-12T18:13:16.508Z",
                "url": "",
                "twitter_handle": "@NickSpies13",
                "facebook_profile": "",
                "linkedin_profile": "",
                "bio": "Nick Spies is a staff analyst at the McDonnell Genome Institute and an MD student at Washington University School of Medicine. He has made substantial contributions to the development of genome analysis tools and resources at the Genome Institute including the Drug-Gene Interaction Database. He is a founding member of the CIViC team, helping to define the CIViC data model, and a leading content curator and a feature development consultant.",
                "country": {
                    "id": 214,
                    "iso": "US",
                    "name": "United States"
                },
                "featured_expert": true,
                "accepted_license": null,
                "signup_complete": null,
                "organizations": [
                    {
                        "id": 12,
                        "name": "Washington University in Saint Louis",
                        "url": "https://wustl.edu/",
                        "description": "Washington University in St. Louis\u2019 mission is to discover and disseminate knowledge, and protect the freedom of inquiry through research, teaching and learning. Washington University creates an environment to encourage and support an ethos of wide-ranging exploration. Washington University\u2019s faculty and staff strive to enhance the lives and livelihoods of students, the people of the greater St. Louis community, the country and the world.",
                        "profile_image": {
                            "x256": "/system/organizations/profile_images/000/000/012/x256/wustl-org.png?1592506215",
                            "x128": "/system/organizations/profile_images/000/000/012/x128/wustl-org.png?1592506215",
                            "x64": "/system/organizations/profile_images/000/000/012/x64/wustl-org.png?1592506215",
                            "x32": "/system/organizations/profile_images/000/000/012/x32/wustl-org.png?1592506215",
                            "x14": "/system/organizations/profile_images/000/000/012/x14/wustl-org.png?1592506215"
                        },
                        "parent": {}
                    },
                    {
                        "id": 1,
                        "name": "The McDonnell Genome Institute",
                        "url": "http://genome.wustl.edu/",
                        "description": "The McDonnell Genome Institute (MGI) is a world leader in the fast-paced, constantly changing field of genomics. A truly unique institution, we are pushing the limits of academic research by creating, testing, and implementing new approaches to the study of biology with the goal of understanding human health and disease, as well as evolution and the biology of other organisms.",
                        "profile_image": {
                            "x256": "/system/organizations/profile_images/000/000/001/x256/mgi-org.png?1592507909",
                            "x128": "/system/organizations/profile_images/000/000/001/x128/mgi-org.png?1592507909",
                            "x64": "/system/organizations/profile_images/000/000/001/x64/mgi-org.png?1592507909",
                            "x32": "/system/organizations/profile_images/000/000/001/x32/mgi-org.png?1592507909",
                            "x14": "/system/organizations/profile_images/000/000/001/x14/mgi-org.png?1592507909"
                        },
                        "parent": {
                            "id": 12,
                            "name": "Washington University in Saint Louis",
                            "url": "https://wustl.edu/",
                            "description": "Washington University in St. Louis\u2019 mission is to discover and disseminate knowledge, and protect the freedom of inquiry through research, teaching and learning. Washington University creates an environment to encourage and support an ethos of wide-ranging exploration. Washington University\u2019s faculty and staff strive to enhance the lives and livelihoods of students, the people of the greater St. Louis community, the country and the world.",
                            "profile_image": {
                                "x256": "/system/organizations/profile_images/000/000/012/x256/wustl-org.png?1592506215",
                                "x128": "/system/organizations/profile_images/000/000/012/x128/wustl-org.png?1592506215",
                                "x64": "/system/organizations/profile_images/000/000/012/x64/wustl-org.png?1592506215",
                                "x32": "/system/organizations/profile_images/000/000/012/x32/wustl-org.png?1592506215",
                                "x14": "/system/organizations/profile_images/000/000/012/x14/wustl-org.png?1592506215"
                            },
                            "parent": {}
                        }
                    }
                ],
                "most_recent_organization": {
                    "id": 1,
                    "name": "The McDonnell Genome Institute",
                    "url": "http://genome.wustl.edu/",
                    "description": "The McDonnell Genome Institute (MGI) is a world leader in the fast-paced, constantly changing field of genomics. A truly unique institution, we are pushing the limits of academic research by creating, testing, and implementing new approaches to the study of biology with the goal of understanding human health and disease, as well as evolution and the biology of other organisms.",
                    "profile_image": {
                        "x256": "/system/organizations/profile_images/000/000/001/x256/mgi-org.png?1592507909",
                        "x128": "/system/organizations/profile_images/000/000/001/x128/mgi-org.png?1592507909",
                        "x64": "/system/organizations/profile_images/000/000/001/x64/mgi-org.png?1592507909",
                        "x32": "/system/organizations/profile_images/000/000/001/x32/mgi-org.png?1592507909",
                        "x14": "/system/organizations/profile_images/000/000/001/x14/mgi-org.png?1592507909"
                    },
                    "parent": {
                        "id": 12,
                        "name": "Washington University in Saint Louis",
                        "url": "https://wustl.edu/",
                        "description": "Washington University in St. Louis\u2019 mission is to discover and disseminate knowledge, and protect the freedom of inquiry through research, teaching and learning. Washington University creates an environment to encourage and support an ethos of wide-ranging exploration. Washington University\u2019s faculty and staff strive to enhance the lives and livelihoods of students, the people of the greater St. Louis community, the country and the world.",
                        "profile_image": {
                            "x256": "/system/organizations/profile_images/000/000/012/x256/wustl-org.png?1592506215",
                            "x128": "/system/organizations/profile_images/000/000/012/x128/wustl-org.png?1592506215",
                            "x64": "/system/organizations/profile_images/000/000/012/x64/wustl-org.png?1592506215",
                            "x32": "/system/organizations/profile_images/000/000/012/x32/wustl-org.png?1592506215",
                            "x14": "/system/organizations/profile_images/000/000/012/x14/wustl-org.png?1592506215"
                        },
                        "parent": {}
                    }
                },
                "conflict_of_interest": {
                    "coi_valid": "missing",
                    "details": {}
                }
            },
            "organization": {
                "id": 1,
                "name": "The McDonnell Genome Institute",
                "url": "http://genome.wustl.edu/",
                "description": "The McDonnell Genome Institute (MGI) is a world leader in the fast-paced, constantly changing field of genomics. A truly unique institution, we are pushing the limits of academic research by creating, testing, and implementing new approaches to the study of biology with the goal of understanding human health and disease, as well as evolution and the biology of other organisms.",
                "profile_image": {
                    "x256": "/system/organizations/profile_images/000/000/001/x256/mgi-org.png?1592507909",
                    "x128": "/system/organizations/profile_images/000/000/001/x128/mgi-org.png?1592507909",
                    "x64": "/system/organizations/profile_images/000/000/001/x64/mgi-org.png?1592507909",
                    "x32": "/system/organizations/profile_images/000/000/001/x32/mgi-org.png?1592507909",
                    "x14": "/system/organizations/profile_images/000/000/001/x14/mgi-org.png?1592507909"
                },
                "parent": {
                    "id": 12,
                    "name": "Washington University in Saint Louis",
                    "url": "https://wustl.edu/",
                    "description": "Washington University in St. Louis\u2019 mission is to discover and disseminate knowledge, and protect the freedom of inquiry through research, teaching and learning. Washington University creates an environment to encourage and support an ethos of wide-ranging exploration. Washington University\u2019s faculty and staff strive to enhance the lives and livelihoods of students, the people of the greater St. Louis community, the country and the world.",
                    "profile_image": {
                        "x256": "/system/organizations/profile_images/000/000/012/x256/wustl-org.png?1592506215",
                        "x128": "/system/organizations/profile_images/000/000/012/x128/wustl-org.png?1592506215",
                        "x64": "/system/organizations/profile_images/000/000/012/x64/wustl-org.png?1592506215",
                        "x32": "/system/organizations/profile_images/000/000/012/x32/wustl-org.png?1592506215",
                        "x14": "/system/organizations/profile_images/000/000/012/x14/wustl-org.png?1592506215"
                    },
                    "parent": {}
                }
            }
        }
    },
    "fields_with_pending_changes": {},
    "gene_id": 78
}