> 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/conveyances.md).

# Conveyances

Conveyances describe tract-level interests contained within land instruments

## Conveyance Object

An object corresponding to a tract conveyance contained within a land instrument. A conveyance combines the tract's legal description with the extracted parties, interest, acreage, granting language, and linked party-address data.

#### Attributes

<table><thead><tr><th width="198.33333333333331">Name</th><th width="159">Type</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>Integer</td><td>Unique conveyance ID</td></tr><tr><td>county</td><td>String</td><td>County named in the legal description.</td></tr><tr><td>city</td><td>String</td><td>City named in the legal description.</td></tr><tr><td>section</td><td>String</td><td>Section identifier.</td></tr><tr><td>township</td><td>String</td><td>Township identifier.</td></tr><tr><td>range</td><td>String</td><td>Range identifier.</td></tr><tr><td>legalBody</td><td>String</td><td>Main legal-description body. This will be the smallest unit of description of the legal and is where quarter calls, metes, and save/except language will be found. When lands are discontinuous they will be delimited with a semicolon.</td></tr><tr><td>subdivision</td><td>String</td><td>Subdivision name.</td></tr><tr><td>lot</td><td>String</td><td>Lot identifier.</td></tr><tr><td>block</td><td>String</td><td>Block identifier.</td></tr><tr><td>grossAcres</td><td>String</td><td>Gross acreage as extracted from the document.</td></tr><tr><td>well</td><td>String</td><td>Well name or identifier.</td></tr><tr><td>abstractId</td><td>String</td><td>Abstract identifier extracted from the conveyance. This ID of the abstract where the file was uploaded.</td></tr><tr><td>survey</td><td>String</td><td>Survey name.</td></tr><tr><td>depthClause</td><td>String</td><td>Depth limitation.</td></tr><tr><td>grantorLessor</td><td>String[]</td><td>Grantor or lessor names attached to the conveyance.</td></tr><tr><td>granteeLessee</td><td>String</td><td>Grantee or lessee name. When linked party data is available, the linked party name is preferred.</td></tr><tr><td>grantingLanguage</td><td>String</td><td>The exact language used to convey. Where things like reservations, wellbore exceptions, and accretion/riparian language will appear.</td></tr><tr><td>grantedPct</td><td>String</td><td>Interest conveyed, returned as extracted text, such as <code>50%</code> or <code>1/2</code> or <code>1.0</code> (meaning 100%).</td></tr><tr><td>grantedBasis</td><td>String</td><td>Basis or category to which the granted interest applies.</td></tr><tr><td>interestTypes</td><td>String[]</td><td>Deduplicated, lowercase interest categories. See <a href="#interest-types">Interest Types</a>.</td></tr><tr><td>pageNumber</td><td>String</td><td>Extracted page number associated with the conveyance.</td></tr><tr><td>statedNet</td><td>String</td><td>When a conveyance has an explicit stated net acreage, extracted text.</td></tr><tr><td>grantorDomainEntities</td><td><a href="#party-with-address-object">PartyWithAddress</a>[]</td><td>Linked grantor parties and their addresses. Returns an empty array when no parties are linked.</td></tr><tr><td>granteeDomainEntities</td><td><a href="#party-with-address-object">PartyWithAddress</a> | null</td><td>Linked grantee party and address, or <code>null</code> when no party is linked.</td></tr><tr><td>referenceInstruments</td><td>String</td><td>Instrument references recorded on the conveyance.</td></tr></tbody></table>

### Interest Types

The `interestTypes` array contains one or more of the following normalized values:

| Value             | Description                            |
| ----------------- | -------------------------------------- |
| minerals          | Mineral interests.                     |
| surface rights    | Rights relating to use of the surface. |
| surface ownership | Ownership of the surface estate.       |
| mineral leasehold | Mineral leasehold interests.           |
| royalties         | Royalty interests.                     |
| wells             | Interests associated with wells.       |
| security interest | Liens or other security interests.     |
| all interest      | All applicable interests.              |

### Party With Address Object

Linked grantor and grantee domain entities use the following shape.

#### Attributes

| Name    | Type   | Description                                                                        |
| ------- | ------ | ---------------------------------------------------------------------------------- |
| name    | String | Normalized linked party name.                                                      |
| address | String | Address associated with the linked party. May be an empty string when unavailable. |

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