Legislative Documents in XML at the United States House of Representatives
Legislative Documents in XML at the United States House of Representatives
XML.HOUSE.GOV Logo

 Features


Bills, Resolutions, and Amendments

Roll Call Votes
Biographical Directory
Committee Report

Member Data

 Additional Resources

Legislative Workflows

Technology Timeline

Resources


Welcome
The purpose of this website is to provide information about the ongoing work of the U.S. House of Representatives in relation to the eXtensible Markup Language (XML).

Under the direction of the Senate Committee on Rules and Administration and the House Committee on Administration, the Secretary of the Senate and the Clerk of the House have worked together with the Congressional Research Service, the Library of Congress and the Government Publishing Office to create Document Type Definition files (DTDs) for use in the creation of legislative documents using XML.

As this is an ongoing effort, it is important to note that the DTDs and examples presented here may change and be extended over time.

Roll Call Votes are available in XML at the Office of the Clerk's website.

Legislation prepared in XML (starting in January 2004) is available on the LOC's site Congress.gov and through GPO’s Federal Digital System (FDsys), govinfo, and Bulk Data repositories.

House staff participate in a number of public forums about this work. Presentations can be found in the Resources section.

Drafting Legislation using XML at the U.S. House of Representatives provides information about the history of drafting legislation in the House and the efforts to create an XML authoring application.


The U.S. Code in XML
On July 30, 2013, the Office of Law Revision Counsel released the United States Code in XML format. The XML files, the schema, a user guide and related files can be found on their download page. Additionally, the schema USLM-1.0.xsd and user guide are available here. To see proposed changes to the USLM schema, follow the discussion on GPO's GitHub repo.

Bill Status in Bulk:
At the direction of the U.S. House of Representatives Appropriations Committee, in support of the Legislative Branch Bulk Data Task Force, the Government Publishing (GPO), the Library of Congress (LOC), the Clerk of the House, and the Secretary of the Senate are planning to make Bill Statuses in XML format available through the GPO’s Federal Digital System (FDsys) Bulk Data repository starting with the 113th Congress. At launch in early 2016, the FDsys Bulk Data repository for Bill Status information will be available at http://www.gpo.gov/fdsys/bulkdata/BILLSTATUS.

Schema files available on GitHub:
In August 2016, GPO made available on GitHub the Bill DTDs and USLM schema files which are used to validate XML files for the U.S. Code, bills, resolutions, and amendments (and the House Rules).


Notice
The document type definitions (DTDs) presented on this site were developed at the U.S. House of Representatives by employees of the Federal Government in the course of their official duties. Pursuant to Title 17 Section 105 of the United States Code, these DTDs are not subject to copyright protection and are in the public domain. These DTDs are in draft form. The U.S. House of Representatives assumes no responsibility whatsoever for their use by other parties, and makes no guarantees, expressed or implied, about their quality, reliability, or any other characteristic. These DTDs can be redistributed and/or modified freely provided that any derivative works bear some notice that they are derived from it, and any modified versions bear some notice that they have been modified.

Bills, Resolutions, and Amendments
Legislative Document Type Definitions, Schemas, and Samples
  Back

  • Bills
  • Resolutions
  • Amendments
  • Element Descriptions
  • Attribute Descriptions




    DTD Schema Root Element
    Bills DTD Bills XSD bill
    Resolutions DTD Resolutions XSD resolution
    Amendment DTD Amendment XSD amendment-doc

    Element Descriptions and Content Models for Bills, Resolutions, and Amendments

    account
    action
    action-date
    action-desc
    action-instruction
    act-name
    added-phrase
    after-quoted-block
    amendment
    amendment-block
    amendment-body
    amendment-doc
    amendment-form
    amendment-instruction
    amend-num
    appropriations-para
    associated-doc
    attestation
    attestation-date
    attestation-group
    attestor
    bill
    bold
    calendar
    chapter
    clause
    colspec
    committee-appointment-paragraph
    committee-name
    congress
    constitution-article
    continuation-text
    cosponsor
    current-chamber
    definition
    deleted-phrase
    distribution-code
    division
    editorial
    effective-date
    endorsement
    entry
    enum
    enum-in-header
    external-xref
    form
    footnote
    footnote-ref
    formula
    fraction
    graphic
    header
    header-in-text
    impeachment-resolution-signature
    inline-comment
    instructive-para
    internal-xref
    image-data
    italic
    item
    legis-body
    legis-num
    legis-type
    level-header
    linebreak
    list
    list-item
    marker
    multi-column-toc-entry
    multi-column-toc-quoted-entry
    nobreak
    nonsponsor
    non-statutory-material
    official-title
    official-title-amendment
    omitted-text
    pagebreak
    page-num
    para
    paragraph
    part
    preamble
    proviso
    proxy
    purpose
    quote
    quoted-block
    quoted-block-continuation-text
    resolution
    resolution-body
    resolution-signature
    role
    row
    rule
    rules-clause
    rules-clause-header
    rules-item
    rules-paragraph
    rules-subdivision
    rules-subitem
    rules-subparagraph
    section
    session
    short-title
    sponsor
    subaccount
    subchapter
    subclause
    subdivision
    subheader
    subitem
    subparagraph
    subpart
    subscript
    subsection
    subsubaccount
    subsubsubaccount
    subtitle
    superscript
    table
    target
    tbody
    tdesc
    term
    text
    tgroup
    thead
    title
    toc
    toc-entry
    toc-enum
    toc-quoted-entry
    ttitle
    whereas



    Roll Call Votes
    Legislative Document Type Definitions, Schemas, and Samples
      Back

     Features  Additional Vote Resources
  • Element Descriptions
  • House Electronic Voting Machine
  • Roll Call votes are available in XML for House votes from 1990 to the present.
  • House Roll Call Votes - Current Congress
  • House Roll Call Votes - Previous Congresses
  • Senate Votes Information




  • DTD Schema Root Element Sample(s)
    Roll Call DTD Roll Call XSD rollcall-vote Roll Call Votes 112th Congress 1st Session

    Element Descriptions and Content Models for the Roll Call Votes DTD

    action-date
    action-time
    amendment-author
    amendment-num
    aye-total
    candidate-total
    candidate
    chamber
    committee
    committee-name
    congress
    legis-num
    legislator
    majority
    nay-total
    no-total
    not-voting-total
    party
    present-total
    recorded-vote
    rollcall-num
    rollcall-vote
    session
    total-stub
    totals-by-candidate
    totals-by-party-header
    totals-by-party
    totals-by-vote
    vote-correction
    vote-data
    vote-descr
    vote-issue
    vote-metadata
    vote-question
    vote-result
    vote-totals
    vote-type
    vote
    yea-total





    Biographical Directory
    Legislative Document Type Definitions, Schemas, and Samples
      Back

     Features  Additional Biographical Resource
  • Element Descriptions
  • Biographical Directory of the United States Congress


  • DTD Schema Root Element Sample(s)
    Bioguide DTD NA uscongress-bio Bioguide Samples (zip file)




    all-works
    bibliography
    biography
    birth-year
    collection
    congress-number
    death-year
    entry
    firstnames
    formal-bibliography
    guide
    homepage
    info
    institution-citystate
    institution-department
    institution-name
    institution-subname
    institution-url
    italic
    lastname
    member-works
    name
    nonmember-works
    papers
    papers-description
    papers-details
    papers-type
    party
    personal-info
    photo-credit
    place
    position
    relative
    relatives
    repo-info
    term
    term-party
    term-position
    term-state
    time-served
    type
    uscongress-bio





    Member Data in XML

    DTD Schema User Guide Sample(s)
    Member Data DTD Member Data schema User Guide Sample [April, 2015 data]



     

     


    Committee Report


    DTD Schema Root Element
    Committee Report DTD Committee Report XSD NA NA

     

     


    this page last updated: September 2, 2016 (updated links; moved World e-Parliament conference material to Resources section; added info about GPO's github repo)