GET api/v2/waterrights/netamount

Returns current status of a water right based on all of its court decreed actions

NameDescriptionType
adjudicationDate

Type of adjudication

date
adminNumber

A calculated number developed by DWR to rank water rights in order of seniority. The priority of the water right is based on the appropriation date and whether the water right is subject to the Subordination Doctrine. The appropriation date is the date decreed by the court that the water was first put to the decreed beneficial use. The Subordination Doctrine established by the court says water rights that are adjudicated after other water rights in their stream system must be subordinate to those rights previously decreed, regardless of their appropriation date. To determine whether or not a water right is subject to the Subordination Doctrine, DWR determines the "previous adjudication date" associated with the water right. Water rights that have no previous adjudication date or have an appropriation date that is later than the previous adjudication date can simply use their appropriation date as their administrative priority. Water rights with an appropriation date the same as or earlier than the previous adjudication date must be subordinated to those previously decreed rights. Using the appropriation date and previous adjudication date, the Priority Admin No (PAN) is calculated as follows:

  • If a water right has no previous adjudication date or the appropriation date of the water right is later than the previous adjudication date: the left side of the PAN is the number of days between 12/31/1849 and the appropriation date; and, the right side of the PAN is zeros (.00000).
  • If the appropriation date of a water right is the same as or earlier than the previous adjudication date: the left side of the PAN is the number of days between 12/31/1849 and the previous adjudication date; and, the right side is the number of days between 12/31/1849 and the appropriation date.
  • decimal number
    appropriationDate

    The date that water was first put to a specific beneficial use or the date that an open, overt act was taken at the intended point of diversion to demonstrate an intent to apply water for beneficial use.

    date
    associatedCaseNumbers

    Water court case number(s) associated with water right

    string
    comments

    Comments

    string
    coordinatesEw

    Distance and direction from East/West section line (feet)

    integer
    coordinatesEwDir

    Direction of measurement from East/West section line

    string
    coordinatesNs

    Distance and direction from North/South section line (feet)

    integer
    coordinatesNsDir

    Direction of measurement from North/South section line

    string
    county

    County where the well is located

    string
    decreedUnits

    Decree Units (either CFS or AF)

    string
    decreedUses

    Beneficial uses of water right: • 0 - STORAGE • 1 - IRRIGATION • 2 - MUNICIPAL • 3 - COMMERCIAL • 4- INDUSTRIAL • 5 - RECREATION • 6 - FISHERY • 7 - FIRE • 8 - DOMESTIC • 9 - STOCK • A - AUGMENTATION • B - SUB-BASIN EXPORT • C - CHANGE OF USE RETURN FLOW • E - EVAPORATIVE • F - FEDERAL RESERVED • G - GEOTHERMAL • H - HOUSEHOLD USE ONLY • K - SNOW MAKING • M - MINIMUM STREAMFLOW • P - POWER GENERATION • Q - OTHER • R - RECHARGE • S - EXPORT FROM STATE • T - TRANSMOUNTAIN EXPORT • W - WILDLIFE • X - ALL BENEFICIAL USES

    string
    division

    DWR Water Division

    integer
    gnisId

    Water source - geographic name information system ID

    string
    lastModified

    Last date time that this record was modified in the DWR database

    date
    latitude

    Latitude value in decimal degrees

    decimal number
    locationAccuracy

    Accuracy of location coordinates

    string
    longitude

    Longitude (decimal degrees)

    decimal number
    moreInformation

    Hyperlink to additional details

    string
    netAbsolute

    Summation of absolute water right flow/volumetric transactions

    decimal number
    netApexAbsolute

    Summation of absolute water right alternate point / exchange flow/volumetric transactions.

    decimal number
    netApexConditional

    Summation of conditional water right alternate point / exchange flow/volumetric transactions.

    decimal number
    netConditional

    Summation of conditional water right flow/volumetric transactions

    decimal number
    orderNumber

    Used to distinguish the priority of multiple water rights with identical dates

    integer
    permit

    Well permit number

    string
    pm

    Principal Meridian of well’s legal location - there are 5 principal meridians in CO: Sixth (S), New Mexico (N), Baca (B), Costilla (C), and Ute (U)

    string
    priorAdjudicationDate

    The previous adjudication date field allows water rights to be ordered by priority with all rights awarded subsequent to a previous adjudication being junior

    date
    priorityNumber

    An early District Court’s method to indicate a water right’s seniority in a water drainage

    string
    q10

    Legal location: 10 acre quarter section

    string
    q160

    Legal location: 160 acre quarter section

    string
    q40

    Legal location: 40 acre quarter section

    string
    range

    Legal location: A number in the format “nnnd” where “nnn” is the range number and “d” is the direction either East or West

    string
    seasonalLimitation

    Flag indicating that the water right has decreed amounts that vary by date

    string
    section

    Section number - township, range divided into 36 one square mile sections; “U” indicates location in Ute Correction (Division 7 only)

    string
    streamMile

    Distance in miles to the confluence with the next downstream water source (or distance to state line)

    decimal number
    structureName

    Name of Structure

    string
    structureType

    Type of structure

    string
    township

    Legal location: Township number and direction

    string
    utmX

    The x (Easting) component of the Universal Transverse Mercator system. (Zone 13, NAD83 datum)

    decimal number
    utmY

    The y (Northing) component of the Universal Transverse Mercator system. (Zone 13, NAD83 datum)

    decimal number
    waterDistrict

    DWR Water District

    integer
    waterRightNetAmtNum

    NA

    integer
    waterSource

    Name of the water source as specified in the court case

    string
    wdid

    DWR unique structure identifier

    string

    Response Formats

    application/json, text/json
    Sample:
    [
      {
        "waterRightNetAmtNum": 1,
        "wdid": "sample string 2",
        "structureName": "sample string 3",
        "structureType": "sample string 4",
        "waterSource": "sample string 5",
        "gnisId": "sample string 6",
        "streamMile": 1.0,
        "division": 7,
        "waterDistrict": 8,
        "county": "sample string 9",
        "q10": "sample string 10",
        "q40": "sample string 11",
        "q160": "sample string 12",
        "section": "sample string 13",
        "township": "sample string 14",
        "range": "sample string 15",
        "pm": "sample string 16",
        "coordinatesEw": 1,
        "coordinatesEwDir": "sample string 17",
        "coordinatesNs": 1,
        "coordinatesNsDir": "sample string 18",
        "utmX": 1.0,
        "utmY": 1.0,
        "latitude": 1.0,
        "longitude": 1.0,
        "locationAccuracy": "sample string 19",
        "adjudicationDate": "2024-05-21T23:12:55.7732-06:00",
        "priorAdjudicationDate": "2024-05-21T23:12:55.7732-06:00",
        "appropriationDate": "2024-05-21T23:12:55.7732-06:00",
        "adminNumber": 23.0,
        "orderNumber": 24,
        "priorityNumber": "sample string 25",
        "associatedCaseNumbers": "sample string 26",
        "decreedUses": "sample string 27",
        "netAbsolute": 1.0,
        "netConditional": 1.0,
        "netApexAbsolute": 1.0,
        "netApexConditional": 1.0,
        "decreedUnits": "sample string 28",
        "seasonalLimitation": "sample string 29",
        "comments": "sample string 30",
        "lastModified": "2024-05-21T23:12:55.7732-06:00",
        "permit": "sample string 32",
        "moreInformation": "sample string 33"
      },
      {
        "waterRightNetAmtNum": 1,
        "wdid": "sample string 2",
        "structureName": "sample string 3",
        "structureType": "sample string 4",
        "waterSource": "sample string 5",
        "gnisId": "sample string 6",
        "streamMile": 1.0,
        "division": 7,
        "waterDistrict": 8,
        "county": "sample string 9",
        "q10": "sample string 10",
        "q40": "sample string 11",
        "q160": "sample string 12",
        "section": "sample string 13",
        "township": "sample string 14",
        "range": "sample string 15",
        "pm": "sample string 16",
        "coordinatesEw": 1,
        "coordinatesEwDir": "sample string 17",
        "coordinatesNs": 1,
        "coordinatesNsDir": "sample string 18",
        "utmX": 1.0,
        "utmY": 1.0,
        "latitude": 1.0,
        "longitude": 1.0,
        "locationAccuracy": "sample string 19",
        "adjudicationDate": "2024-05-21T23:12:55.7732-06:00",
        "priorAdjudicationDate": "2024-05-21T23:12:55.7732-06:00",
        "appropriationDate": "2024-05-21T23:12:55.7732-06:00",
        "adminNumber": 23.0,
        "orderNumber": 24,
        "priorityNumber": "sample string 25",
        "associatedCaseNumbers": "sample string 26",
        "decreedUses": "sample string 27",
        "netAbsolute": 1.0,
        "netConditional": 1.0,
        "netApexAbsolute": 1.0,
        "netApexConditional": 1.0,
        "decreedUnits": "sample string 28",
        "seasonalLimitation": "sample string 29",
        "comments": "sample string 30",
        "lastModified": "2024-05-21T23:12:55.7732-06:00",
        "permit": "sample string 32",
        "moreInformation": "sample string 33"
      }
    ]
    
    application/xml, text/xml
    Sample:
    <ArrayOfWaterRightsNetAmount xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
      <WaterRightsNetAmount>
        <adjudicationDate>2024-05-21T23:12:55.7732-06:00</adjudicationDate>
        <adminNumber>23</adminNumber>
        <appropriationDate>2024-05-21T23:12:55.7732-06:00</appropriationDate>
        <associatedCaseNumbers>sample string 26</associatedCaseNumbers>
        <comments>sample string 30</comments>
        <coordinatesEw>1</coordinatesEw>
        <coordinatesEwDir>sample string 17</coordinatesEwDir>
        <coordinatesNs>1</coordinatesNs>
        <coordinatesNsDir>sample string 18</coordinatesNsDir>
        <county>sample string 9</county>
        <decreedUnits>sample string 28</decreedUnits>
        <decreedUses>sample string 27</decreedUses>
        <division>7</division>
        <gnisId>sample string 6</gnisId>
        <lastModified>2024-05-21T23:12:55.7732-06:00</lastModified>
        <latitude>1</latitude>
        <locationAccuracy>sample string 19</locationAccuracy>
        <longitude>1</longitude>
        <moreInformation>sample string 33</moreInformation>
        <netAbsolute>1</netAbsolute>
        <netApexAbsolute>1</netApexAbsolute>
        <netApexConditional>1</netApexConditional>
        <netConditional>1</netConditional>
        <orderNumber>24</orderNumber>
        <permit>sample string 32</permit>
        <pm>sample string 16</pm>
        <priorAdjudicationDate>2024-05-21T23:12:55.7732-06:00</priorAdjudicationDate>
        <priorityNumber>sample string 25</priorityNumber>
        <q10>sample string 10</q10>
        <q160>sample string 12</q160>
        <q40>sample string 11</q40>
        <range>sample string 15</range>
        <seasonalLimitation>sample string 29</seasonalLimitation>
        <section>sample string 13</section>
        <streamMile>1</streamMile>
        <structureName>sample string 3</structureName>
        <structureType>sample string 4</structureType>
        <township>sample string 14</township>
        <utmX>1</utmX>
        <utmY>1</utmY>
        <waterDistrict>8</waterDistrict>
        <waterRightNetAmtNum>1</waterRightNetAmtNum>
        <waterSource>sample string 5</waterSource>
        <wdid>sample string 2</wdid>
      </WaterRightsNetAmount>
      <WaterRightsNetAmount>
        <adjudicationDate>2024-05-21T23:12:55.7732-06:00</adjudicationDate>
        <adminNumber>23</adminNumber>
        <appropriationDate>2024-05-21T23:12:55.7732-06:00</appropriationDate>
        <associatedCaseNumbers>sample string 26</associatedCaseNumbers>
        <comments>sample string 30</comments>
        <coordinatesEw>1</coordinatesEw>
        <coordinatesEwDir>sample string 17</coordinatesEwDir>
        <coordinatesNs>1</coordinatesNs>
        <coordinatesNsDir>sample string 18</coordinatesNsDir>
        <county>sample string 9</county>
        <decreedUnits>sample string 28</decreedUnits>
        <decreedUses>sample string 27</decreedUses>
        <division>7</division>
        <gnisId>sample string 6</gnisId>
        <lastModified>2024-05-21T23:12:55.7732-06:00</lastModified>
        <latitude>1</latitude>
        <locationAccuracy>sample string 19</locationAccuracy>
        <longitude>1</longitude>
        <moreInformation>sample string 33</moreInformation>
        <netAbsolute>1</netAbsolute>
        <netApexAbsolute>1</netApexAbsolute>
        <netApexConditional>1</netApexConditional>
        <netConditional>1</netConditional>
        <orderNumber>24</orderNumber>
        <permit>sample string 32</permit>
        <pm>sample string 16</pm>
        <priorAdjudicationDate>2024-05-21T23:12:55.7732-06:00</priorAdjudicationDate>
        <priorityNumber>sample string 25</priorityNumber>
        <q10>sample string 10</q10>
        <q160>sample string 12</q160>
        <q40>sample string 11</q40>
        <range>sample string 15</range>
        <seasonalLimitation>sample string 29</seasonalLimitation>
        <section>sample string 13</section>
        <streamMile>1</streamMile>
        <structureName>sample string 3</structureName>
        <structureType>sample string 4</structureType>
        <township>sample string 14</township>
        <utmX>1</utmX>
        <utmY>1</utmY>
        <waterDistrict>8</waterDistrict>
        <waterRightNetAmtNum>1</waterRightNetAmtNum>
        <waterSource>sample string 5</waterSource>
        <wdid>sample string 2</wdid>
      </WaterRightsNetAmount>
    </ArrayOfWaterRightsNetAmount>