Office of the Revisor of Statutes

Please note: The following changes have recently been made:

Elements that provided Keys have been removed. For example, /BILL/AUTHORS/*/AUTHOR/AUTHOR_KEY is no longer available.
/BILL/TEXT_VERSION_LIST/DOCUMENT/DOCUMENT_TYPE now says "official" instead of "bill" or "resolution" for introductions and official engrossments.
/BILL/ACTIONS/*/ACTION/ACTION_TYPE is no longer available.

Usage

Step 1: Create a bill search

Navigate to the Bill Search & Status (House) page. In this example we'll do a search for House bills in the 94th Legislative session with a bill number of 1 through 10.

Screenshot of house bill search page, entering 1-10 in Search by Bill Numbers entry field.

Step 2: Modify the URL

The search page results are displayed as an HTML page. In order to retrieve the results as XML data, we simply append &format=xml to the URL.
www.revisor.mn.gov/bills/status_result.php?body=House&search=basic&session=0892015&location=House&bill=1-10&bill_type=bill&rev_number=&submit_bill=GO&keyword_type=all&keyword=&keyword_field_text=1&titleword=&format=xml

Screenshot of adding &format=xml to search result URL.

Step 3: Parse results

The search result XML format is a list of <BILL_RESULT> elements. These elements provide a few details about the bill. To get more information about a resulting bill navigate to the URI found in the <STATUS_XML_URI> element.

  
<SEARCH_RESULTS>
  <API_INFO>Web service API information: www.revisor.mn.gov/bills/service</API_INFO>
  <BILL_RESULT>
    <FILE_TYPE>HF</FILE_TYPE>
    <FILE_NUMBER>10</FILE_NUMBER>
    <STATUS_XML_URI>api.revisor.mn.gov/bills/v1/93/2023/0/HF/10/</STATUS_XML_URI>
    <LATEST_TEXT_HTML_URI>www.revisor.mn.gov/bills/93/2023/0/HF/10/latest/</LATEST_TEXT_HTML_URI>
    <DESCRIPTION>Skilled and trained contractor workforce use provided at petroleum refineries.</DESCRIPTION>
  </BILL_RESULT>
  <BILL_RESULT>
    <FILE_TYPE>HF</FILE_TYPE>
    <FILE_NUMBER>9</FILE_NUMBER>
    <STATUS_XML_URI>api.revisor.mn.gov/bills/v1/93/2023/0/HF/9/</STATUS_XML_URI>
    <LATEST_TEXT_HTML_URI>www.revisor.mn.gov/bills/93/2023/0/HF/9/latest/</LATEST_TEXT_HTML_URI>
    <DESCRIPTION>Individual income provisions modified, dependent care credit expanded, and great start child care credit established.</DESCRIPTION>
  </BILL_RESULT>
  <BILL_RESULT>
    <FILE_TYPE>HF</FILE_TYPE>
    <FILE_NUMBER>8</FILE_NUMBER>
    <STATUS_XML_URI>api.revisor.mn.gov/bills/v1/93/2023/0/HF/8/</STATUS_XML_URI>
    <LATEST_TEXT_HTML_URI>www.revisor.mn.gov/bills/93/2023/0/HF/8/latest/</LATEST_TEXT_HTML_URI>
    <DESCRIPTION>Student personnel aid established, and money appropriated.</DESCRIPTION>
  </BILL_RESULT>
</SEARCH_RESULTS>

Step 4: Retrieve full bill record

Issuing an HTTP Get request for the URI found in the result XML <STATUS_XML_URI> element will return the full XML status record for that bill.
api.revisor.mn.gov/bills/v1/94/2025/0/HF/10/

  
<BILL>
  <STATUS_KEY/>
  <FILE_TYPE>HF</FILE_TYPE>
  <FILE_NUMBER>10</FILE_NUMBER>
  <REVISOR_NUMBER>25-03544</REVISOR_NUMBER>
  <COMPANION_TYPE>SF</COMPANION_TYPE>
  <COMPANION_NUMBER>690</COMPANION_NUMBER>
  <SUBSTITUTION_TYPE/>
  <SUBSTITUTION_NUMBER/>
  <DESCRIPTION>
    State-funded payments to undocumented noncitizens prohibited, and 
    undocumented noncitizens provided to be ineligible for MinnesotaCare and 
    North Star Promise scholarship program.
  </DESCRIPTION>
  <LAW_KEY/>
  <SESSION_YEAR>2025</SESSION_YEAR>
  <SESSION_TYPE>0</SESSION_TYPE>
  <SESSION_NUMBER>94</SESSION_NUMBER>
  <SESSION_TEXT>94th Legislature</SESSION_TEXT>
  <SESSION_YEAR_START>2025</SESSION_YEAR_START>
  <SESSION_YEAR_CLOSE>2026</SESSION_YEAR_CLOSE>
  <DOCUMENT_KEY/>
  <LAW_TYPE/>
  <LAW_NUMBER>None</LAW_NUMBER>
  <TEXT_VERSION_LIST>
    <DOCUMENT>
      <HTML_URI>www.revisor.mn.gov/bills/94/HF/10/versions/0/</HTML_URI>
      <DATE_INSERT>2025-02-06 11:26:33</DATE_INSERT>
      <DOCUMENT_NAME>2025.0-HF0010-0</DOCUMENT_NAME>
      <DOCUMENT_TYPE>official</DOCUMENT_TYPE>
      <DOCUMENT_ENGROSSMENT>0</DOCUMENT_ENGROSSMENT>
    </DOCUMENT>
    <DOCUMENT>
      <HTML_URI>www.revisor.mn.gov/bills/94/HF/10/versions/1/</HTML_URI>
      <DATE_INSERT>2025-03-06 15:41:02</DATE_INSERT>
      <DOCUMENT_NAME>2025.0-HF0010-1</DOCUMENT_NAME>
      <DOCUMENT_TYPE>official</DOCUMENT_TYPE>
      <DOCUMENT_ENGROSSMENT>1</DOCUMENT_ENGROSSMENT>
    </DOCUMENT>
  </TEXT_VERSION_LIST>
  <AUTHORS>
    ...
  </AUTHORS>
  <ACTIONS>
    ...
  </ACTIONS>
</BILL>

Feedback

For questions or suggestions about the Bill Status API please contact the Revisor's Office help desk.