This subdirectory of GTR's ftp site contains several reports summarizing labs registering tests in the NIH Genetic Testing Registry (GTR), as well as XML for each test and summary data for each test. Return to GTR's home page Return to browse the directory

This file is: ftp.ncbi.nih.gov/pub/GTR/data/_README.html

Last updated: March 19, 2025

Disclaimer and data use policy

Copyright Status

Information that is created by or for the US government on this site is within the public domain. Public domain information on the National Library of Medicine (NLM) Web pages may be freely distributed and copied. However, it is requested that in any subsequent use of this work, NLM be given appropriate acknowledgment. More information about NCBI's copyright and disclaimer policy is available.

If you distribute or copy data from the NIH Genetic Testing Registry, we ask that you provide attribution to GTR as a data source in publications and websites by:

  1. linking to the GTR website: http://www.ncbi.nlm.nih.gov/gtr/ and/or
  2. citing this publication: http://nar.oxfordjournals.org/content/41/D1/D925.full

IMPORTANT NOTE: NIH does not independently verify information submitted to the GTR; it relies on submitters to provide information that is accurate and not misleading. NIH makes no endorsements of tests or laboratories listed in the GTR. GTR is not a substitute for medical advice. Patients and consumers with specific questions about a genetic test should contact a health care provider or a genetics professional.

This directory contains:

  • Comprehensive extraction of GTR data in an XML format

    • This path includes the file gtr_ftp.xml.gz which represents the publicly available tests registered in the GTR. The XSD to validate this file is in the documentation directory (GTRPublicData.xsd).

    At the end of each month, a copy of the current file is archived in the subdirectory xml_archive.

  • Lab tests by country

    • Summary file of the number of laboratories with tests registered in the GTR, with a breakdown by clinical or research tests. The top data line reports the sum. The file is tab-delimited and regenerated weekly. The columns are:

    1. Country name
    2. Registered Labs: total laboratories registered in the GTR
    3. Labs with clinical tests: the number of the labs in the second column registering clinical tests
    4. Labs with research tests: the number of the labs in the second column registering research tests

  • Test condition and genes

    • A comprehensive listing of tests registered in GTR, and the conditions and genes they target, reported from GTR. The descripion of the test may require more than one line; the lines are linked by the value of the accession_version column.

    tab-delimited (txt), or spreadsheet (xlsx) updated daily

    The columns are:

    1. accession_version: The GTR accession assigned to the test with its current version number.
    2. test_type: The values are Clinical or Research
    3. object: A description of the object of the test. The values are condition or gene.
    4. GTR_identifier: the identifier GTR uses for the condition. This is the concept unique identifier in MedGen.
    5. MIM_number: the identifier assigned by OMIM to this object
    6. gene_or_SNOMED_CT_ID: If the object is a gene, the GeneID from NCBI's gene database; if a condtion, the SNOMED_CT identifier if available.
  • Tests by method category

    • Summary file of the number of tests registered in the GTR using specific methods. The file is tab-delimited and regenerated daily. The columns are:

    1. Major method category
    2. Method category
    3. Total Labs with clinical tests
    4. US Labs with clinical tests
    5. Total Labs with research tests
    6. US Labs with research tests

  • Test version history in tab delimited format

    • Test version history contains a subset of data for all registered publicly available GTR data including their version history. Data included in file

    1. Test accession.version (test_accession_ver)
    2. Name of laboratory (name_of_laboratory)
    3. Name of institution (name_of_institution)
    4. State (facility_state)
    5. Postcode (facility_postcode)
    6. Country (facility_country)
    7. CLIA number (CLIA_number)
    8. State license (state_licenses)
    9. State license numbers (state_license_numbers)
    10. Lab's test ID (lab_test_id)
    11. Date last touched (last_touch_date)
    12. lab_test_name
    13. manufacturer_test_name
    14. test_development
    15. lab_unique_code
    16. condition_identifiers
    17. indication_types
    18. inheritances
    19. method_categories
    20. methods
    21. platforms
    22. genes
    23. drug_responses
    24. If this version of the test is the current version (now_current 1 = current version, 0 = previous version)
    25. If the test is current (test_currStat 1 = current , other values indicate test is not current)
    26. If the test is public (test_pubStat 3 = public, other values indicate current version is no longer public)
    27. If the lab is current (lab_currStat 1 = current , other values indicate lab is not current)
    28. If the lab is public (lab_pubStat3 = public, other values indicate the lab is no longer public)
    29. Date test was first registered in GTR (test_create_date)
    30. Date test was deleted from GTR
    31. Test order code

  • Test accessions with their current versions in comma-delimited format (US only)

    • GTR_test_IDS.csv is a comprehensive list of the current accession and version for all tests in the GTR for labs in the United States, with the date that test was created. If the test has been deleted, the file also reports the date the test was removed from GTR. This file is updated twice a week, on Sundays and Thursdays.

    1. Test accession.version (test_accession_ver)
    2. Date the test was created (test_create_date)
    3. Date the test was deleted, if any (test_deletion_date)

    If you have any question about files on GTR's ftp site, please contact us.