Land Instruments

Land instruments are returned by the Search a Land Abstract endpoint

Land Instrument Object

An object corresponding to one land instrument in an abstract. Land instruments include recording information, parties, dates, source-page boundaries, and conveyances contained within the instrument.

Attributes

Name	Type	Description
subDocumentId	Integer	Unique ID of the instrument.
startPageNumber	Integer	First page of the source file occupied by the instrument.
startPagePct	Number	Vertical position at which the instrument starts on its first page, expressed as a percentage from 0 to 100. Defaults to 0 when no value is stored.
endPageNumber	Integer	Last page of the source file occupied by the instrument.
endPagePct	Number	Vertical position at which the instrument ends on its last page, expressed as a percentage from 0 to 100. Defaults to 100 when no value is stored.
sourceReferenceId	Integer	Unique ID of the source file containing the instrument.
sourceReferenceName	String	Display name or file name of the source reference.
instrumentType	String	Classified instrument type, such as Mineral Deed or Oil and Gas Lease.
comments	String[]	Deduplicated comments extracted from the instrument.
countyBookNumber	String	County recording book number.
countyPageNumber	String	County recording page number.
instrumentTitle	String	Extracted title of the instrument.
interestTypes	String[]	A list of interest types conveyed or modifed in the instrument
grantorNames	String[]	Deduplicated grantor or lessor names.
granteeNames	String[]	Deduplicated grantee or lessee names.
instrumentNumber	String	County instrument or recording number. This property is omitted when no value exists.
effectiveDate	String	Extracted effective date. The text is returned as stored and the property is omitted when no value exists.
primaryTerm	String	Extracted primary term applicable only to leases. This property is omitted when no value exists.
extensionTerm	String	Extracted extension term applicable only to leases. This property is omitted when no value exists.
royaltyRate	String	Extracted royalty rate. This property is omitted when no value exists.
pughClause	String	Extracted Pugh-clause text or value applicable only to leases. This property is omitted when no value exists.
executedDate	String	Extracted execution date. The text is returned as stored and the property is omitted when no value exists.
fileDate	String	Extracted filing date. The text is returned as stored and the property is omitted when no value exists.
recordedDate	String	Extracted recording date. The text is returned as stored and the property is omitted when no value exists.
referencedInstruments	String[]	References to other instruments. Reference instruments are strings in the format of -bk-pg-
conveyances	Conveyance[]	Tract-level conveyances located within the instrument. An empty array means that no conveyances exist.

String-array annotations are deduplicated using a case-insensitive, alphanumeric comparison. Returned values retain their stored display text.

{
  "subDocumentId": 10482,
  "startPageNumber": 3,
  "startPagePct": 0,
  "endPageNumber": 7,
  "endPagePct": 100,
  "sourceReferenceId": 615,
  "sourceReferenceName": "2024-001234.pdf",
  "instrumentType": "Mineral Deed",
  "comments": [
    "Legal description continues on Exhibit A"
  ],
  "countyBookNumber": "182",
  "countyPageNumber": "417",
  "instrumentTitle": "Mineral Deed",
  "interestTypes": [
    "Minerals"
  ],
  "grantorNames": [
    "Example Grantor, LLC"
  ],
  "granteeNames": [
    "Example Grantee, LP"
  ],
  "instrumentNumber": "2024-001234",
  "effectiveDate": "01/15/2024",
  "primaryTerm": "3 Years",
  "extensionTerm": "1 Year",
  "royaltyRate": "",
  "pughClause": "",
  "executedDate": "01/15/2024",
  "fileDate": "01/22/2024",
  "recordedDate": "01/22/2024",
  "referencedInstruments": ["Reeves-bk140-pg133-inst#1738"],
  "conveyances": [
    {
      "id": 78301,
      "county": "Reeves",
      "city": "",
      "section": "12",
      "township": "2S",
      "range": "",
      "legalBody": "NW/4",
      "subdivision": "",
      "lot": "",
      "block": "C-8",
      "grossAcres": "160",
      "well": "",
      "abstractId": "42",
      "survey": "Public School Land",
      "depthClause": "Pertaining only to the wolfcamp formation",
      "grantorLessor": ["Example Grantor, LLC"],
      "granteeLessee": "Example Grantee, LP",
      "grantingLanguage": "grants, sells, and conveys",
      "grantedPct": "1/3",
      "grantedBasis": "Entire",
      "interestTypes": ["minerals"],
      "pageNumber": "4",
      "statedNet": "3.25",
      "grantorDomainEntities": [
        {
          "name": "Example Grantor, LLC",
          "address": "100 Main Street, Midland, TX 79701"
        }
      ],
      "granteeDomainEntities": {
        "name": "Example Grantee, LP",
        "address": "200 Market Street, Houston, TX 77002"
      },
      "referenceInstruments": "Reeves-bk140-pg133-inst#1738"
    }
  ]
}