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

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

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.

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