> For the complete documentation index, see [llms.txt](https://docs.annolab.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.annolab.ai/annotations-and-relations/land-instruments.md).

# 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

<table><thead><tr><th width="198.33333333333331">Name</th><th width="159">Type</th><th>Description</th></tr></thead><tbody><tr><td>subDocumentId</td><td>Integer</td><td>Unique ID of the instrument.</td></tr><tr><td>startPageNumber</td><td>Integer</td><td>First page of the source file occupied by the instrument.</td></tr><tr><td>startPagePct</td><td>Number</td><td>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.</td></tr><tr><td>endPageNumber</td><td>Integer</td><td>Last page of the source file occupied by the instrument.</td></tr><tr><td>endPagePct</td><td>Number</td><td>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.</td></tr><tr><td>sourceReferenceId</td><td>Integer</td><td>Unique ID of the source file containing the instrument.</td></tr><tr><td>sourceReferenceName</td><td>String</td><td>Display name or file name of the source reference.</td></tr><tr><td>instrumentType</td><td>String</td><td>Classified instrument type, such as <code>Mineral Deed</code> or <code>Oil and Gas Lease</code>.</td></tr><tr><td>comments</td><td>String[]</td><td>Deduplicated comments extracted from the instrument.</td></tr><tr><td>countyBookNumber</td><td>String</td><td>County recording book number.</td></tr><tr><td>countyPageNumber</td><td>String</td><td>County recording page number.</td></tr><tr><td>instrumentTitle</td><td>String</td><td>Extracted title of the instrument.</td></tr><tr><td>interestTypes</td><td>String[]</td><td>A list of interest types conveyed or modifed in the instrument</td></tr><tr><td>grantorNames</td><td>String[]</td><td>Deduplicated grantor or lessor names.</td></tr><tr><td>granteeNames</td><td>String[]</td><td>Deduplicated grantee or lessee names.</td></tr><tr><td>instrumentNumber</td><td>String</td><td>County instrument or recording number. This property is omitted when no value exists.</td></tr><tr><td>effectiveDate</td><td>String</td><td>Extracted effective date. The text is returned as stored and the property is omitted when no value exists.</td></tr><tr><td>primaryTerm</td><td>String</td><td>Extracted primary term applicable only to leases. This property is omitted when no value exists.</td></tr><tr><td>extensionTerm</td><td>String</td><td>Extracted extension term applicable only to leases. This property is omitted when no value exists.</td></tr><tr><td>royaltyRate</td><td>String</td><td>Extracted royalty rate. This property is omitted when no value exists.</td></tr><tr><td>pughClause</td><td>String</td><td>Extracted Pugh-clause text or value applicable only to leases. This property is omitted when no value exists.</td></tr><tr><td>executedDate</td><td>String</td><td>Extracted execution date. The text is returned as stored and the property is omitted when no value exists.</td></tr><tr><td>fileDate</td><td>String</td><td>Extracted filing date. The text is returned as stored and the property is omitted when no value exists.</td></tr><tr><td>recordedDate</td><td>String</td><td>Extracted recording date. The text is returned as stored and the property is omitted when no value exists.</td></tr><tr><td>referencedInstruments</td><td>String[]</td><td>References to other instruments. Reference instruments are strings in the format of -bk-pg-</td></tr><tr><td>conveyances</td><td><a href="https://docs.annolab.ai/annotations-and-relations/conveyances">Conveyance</a>[]</td><td>Tract-level conveyances located within the instrument. An empty array means that no conveyances exist.</td></tr></tbody></table>

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

```json
{
  "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"
    }
  ]
}
```