Abstracts

Abstracts are an ordered collection of instruments and typically represent a title summary.

Abstract Object

Attributes

Name

Type

Description

Integer

Unique id of the abstract

key

String

A unique key for the abstract

Abstract Instrument Object

Create Abstract

POST https://api.annolab.ai/v1/abstract/create

Create a new abstract in a project. Each area of interest (AOI) is the land models target when examining documents. They are stored as one or more Legal Description tags on the abstract. Newly created abstracts start with no instruments; instruments are added as they are matched to those tags.

The project must already have a Legal Description tag type. Creating an abstract requires an API key with "Write" permissions, and the key's user must have view access to the project.

Headers

Name

Type

Description

Authorization

string

Where you put your api key. Creating an abstract requires a key with "Write" permissions. {"Authorization": "Api-Key XXXXXXX-XXXXXXX-XXXXXXX"}

Request Body

Name

Type

Description

name

string

Name of the abstract to create

projectIdentifier

string|integer

Id or unique name of the project that will contain the abstract

groupName

string

Optional. Group that owns the project. When provided, the project is resolved as that group's project named or identified by projectIdentifier. Omit to resolve the project from the API key's user.

aois

AOI[]

At least one area of interest. Models use these to extract only information relevant to the target land. Each AOI is converted into Legal Description tags on the abstract. See Texas AOIs for how a single Texas AOI can produce two tags.

subdivisions

string[]

Optional. Subdivision names to associate with the abstract

{
    "id": 1842,
    "key": "sec-12-t3n-r4w-garvin-ok",
    "projectId": 22,
    "tags": [
        {
            "typeName": "Legal Description",
            "domainEntityId": 901,
            "attributes": [
                {"name": "Section", "value": "12"},
                {"name": "Township", "value": "3N"},
                {"name": "Range", "value": "4W"},
                {"name": "County", "value": "Garvin"},
                {"name": "State", "value": "OK"}
            ]
        }
    ],
    "instruments": [],
    "createdAt": "2026-08-20T18:00:00.000Z",
    "updatedAt": "2026-08-20T18:00:00.000Z",
    "createdBy": {"id": 14, "username": "tester", "email": "tester@gmail.com"},
    "updatedBy": {"id": 14, "username": "tester", "email": "tester@gmail.com"}
}

{
    "message": "Project Example Project does not exist"
}

{
    "message": "You do not have permission to create an abstract in that project."
}

A 400 is also returned when the project is missing a Legal Description tag type:

{
    "message": "Project is missing a \"Legal Description\" tag type required to store AOIs."
}

Example of how to make the request to create an abstract

import requests

ANNO_LAB_API_KEY = 'XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX'

abstract = {
  'projectIdentifier': 'Example Land Project',
  'name': 'Garvin 12-3N-4W',
  'aois': [
    {
      'state': 'OK',
      'county': 'Garvin',
      'section': '12',
      'township': '3N',
      'range': '4W'
    }
  ],
  'subdivisions': ['NW/4']
}

headers = {
  'Authorization': 'Api-Key '+ANNO_LAB_API_KEY,
}

url = 'https://api.annolab.ai/v1/abstract/create'

response = requests.post(url, headers=headers, json=abstract)

print(response.json())

Get Predicted Owners

POST https://api.annolab.ai/v1/abstract/land/predicted-owners

Ownership predictions require running the ownership chain agent first. See Ownership Chain Agent.

Return predicted mineral owners for a land abstract. Each result is a party ownership prediction, including the related party and the legal description the prediction applies to.

Requires an API key with "Read" permissions, and the key's user must have view access to the abstract's project.

Headers

Name

Type

Description

Authorization

string

Where you put your api key. Getting predicted owners requires a key with "Read" permissions. {"Authorization": "Api-Key XXXXXXX-XXXXXXX-XXXXXXX"}

Request Body

Name

Type

Description

projectIdentifier

string|integer

Id or unique name of the project that contains the abstract

abstractIdentifier

string|integer

Id or name of the abstract

groupName

string

Optional. Group that owns the project. When provided, the project is resolved as that group's project named or identified by projectIdentifier.

[
    {
        "id": 91,
        "partyId": 4401,
        "abstractId": 1842,
        "ownsInterest": true,
        "predictionNotes": "Grantor retained a mineral interest in the NW/4.",
        "section": "12",
        "township": "3N",
        "range": "4W",
        "legalBody": "NW/4",
        "lot": null,
        "subdivision": "NW/4",
        "predictionConfidence": "high",
        "interestTypes": ["Mineral"],
        "createdAt": "2026-08-25T18:00:00.000Z",
        "updatedAt": "2026-08-25T18:00:00.000Z",
        "party": {
            "id": 4401,
            "abstractId": 1842,
            "fullName": "Jane Doe",
            "partyType": "Person",
            "firstName": "Jane",
            "middleName": null,
            "lastName": "Doe",
            "suffix": null,
            "tradeName": null,
            "aliases": [],
            "addresses": []
        }
    }
]

{
    "message": "Project 'Example Land Project' does not exist"
}

{
    "message": "You do not have permission to view abstracts in that project."
}

{
    "message": "No abstract exists with the identifier <Garvin 12-3N-4W>"
}

import requests

ANNO_LAB_API_KEY = 'XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX'

headers = {
  'Authorization': 'Api-Key '+ANNO_LAB_API_KEY,
}

body = {
  'projectIdentifier': 'Example Land Project',
  'abstractIdentifier': 'Garvin 12-3N-4W'
}

url = 'https://api.annolab.ai/v1/abstract/land/predicted-owners'

response = requests.post(url, headers=headers, json=body)

print(response.json())

Area of Interest (AOI) Object

An AOI is the target land for an abstract. When models examine documents, they use the AOI to cut through noise and extract only information relevant to that area. The exception is leases: when analyzing a lease, models extract lands both within the AOI and outside lands.

county and state are always required. state must be a two-letter US abbreviation. The remaining fields depend on whether the AOI is in Texas.

Omitted optional fields are stored as empty strings on the resulting Legal Description tag.

Non-Texas AOI

Use this shape when state is any US abbreviation except TX.

Name

Type

Description

county

string

County name

state

string

Two-letter US state abbreviation other than TX

section

string

Optional PLSS section

township

string

Optional PLSS township

range

string

Optional PLSS range

{
  "state": "OK",
  "county": "Garvin",
  "section": "12",
  "township": "3N",
  "range": "4W"
}

Each non-Texas AOI creates one Legal Description tag with Section, Township, Range, County, and State.

Texas AOI

Use this shape when state is TX.

Name

Type

Description

county

string

County name

state

string

Must be TX

section

string

Optional section

block

string

Optional block

township

string

Optional township

abstract

string

Optional abstract number / abstract id

survey

string

Optional survey name

{
  "state": "TX",
  "county": "Midland",
  "section": "18",
  "block": "37",
  "township": "T1S",
  "abstract": "A-123",
  "survey": "T&P RR Co"
}

A Texas AOI can create one or two Legal Description tags:

Block / township tag (Section, Block, Township, Survey Name, County, State) when block or township is provided, or when block, township, and abstract are all omitted.
Abstract tag (Section, Abstract Id, Survey Name, County, State) when abstract is provided.

If both block/township and abstract are present, both tags are created. If only abstract is provided, only the abstract tag is created.

Example of creating an abstract from a Texas AOI

import requests

ANNO_LAB_API_KEY = 'XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX'

abstract = {
  'projectIdentifier': 'Example Land Project',
  'name': 'Midland 18-37',
  'aois': [
    {
      'state': 'TX',
      'county': 'Midland',
      'section': '18',
      'block': '37',
      'township': 'T1S',
      'abstract': 'A-123',
      'survey': 'T&P RR Co'
    }
  ]
}

headers = {
  'Authorization': 'Api-Key '+ANNO_LAB_API_KEY,
}

url = 'https://api.annolab.ai/v1/abstract/create'

response = requests.post(url, headers=headers, json=abstract)

print(response.json())

Predicted Owner Object

Name

Type

Description

Integer

Unique id of the ownership prediction

partyId

Integer

Id of the predicted owner party

abstractId

Integer

Id of the abstract

ownsInterest

Boolean

Whether the party is predicted to own an interest

predictionNotes

String

Explanation of the prediction

section

String|null

Section the prediction applies to

township

String|null

Township the prediction applies to

range

String|null

Range the prediction applies to

legalBody

String|null

Legal body / tract description

lot

String|null

Lot the prediction applies to

subdivision

String|null

Subdivision the prediction applies to

predictionConfidence

String

Confidence of the prediction

interestTypes

String[]

Predicted interest types, for example Mineral

createdAt

String

ISO formatted DateTime when the prediction was created

updatedAt

String

ISO formatted DateTime when the prediction was last updated

party

Object|null

Party details: id, fullName, partyType, name parts, aliases, addresses

PreviousSearch Land Abstract

NextOwnership Chain Agent

Last updated 13 days ago

Was this helpful?