api.locus.report | Apiosk Gateway

Method	Path	Description	Cost
POST	/api/locus-practitioner-read	Hedged prose from cited property records for one place. Each reading names the confirming record; an optional question sets the audience and focus. No value, person motive, or buildability finding. Allow at least 60 seconds (90 recommended). If disconnected, retry the same request for the same payer with fresh valid payment within 15 minutes; no charge occurs for the disconnected run. npx @velinussage/locus-agent-skill add.	$0.33 default	View details

POST/api/locus-practitioner-read

$0.33 default

Description

Hedged prose from cited property records for one place. Each reading names the confirming record; an optional question sets the audience and focus. No value, person motive, or buildability finding. Allow at least 60 seconds (90 recommended). If disconnected, retry the same request for the same payer with fresh valid payment within 15 minutes; no charge occurs for the disconnected run. npx @velinussage/locus-agent-skill add.

Pricing

$0.33 default

Request schema

{
  "additionalProperties": false,
  "properties": {
    "address": {
      "maxLength": 200,
      "minLength": 5,
      "type": "string"
    },
    "persona": {
      "enum": [
        "buyer",
        "owner",
        "seller",
        "investor",
        "renter",
        "lender",
        "developer",
        "commercial_tenant"
      ],
      "type": "string"
    },
    "question": {
      "maxLength": 300,
      "type": "string"
    },
    "radiusMeters": {
      "maximum": 1500,
      "minimum": 100,
      "type": "integer"
    }
  },
  "required": [
    "address"
  ],
  "type": "object"
}

Example response

{
  "address": "1 E Edenton St, Raleigh, NC 27601",
  "catalogue": {
    "evaluated": 0,
    "gated": 0
  },
  "catalogueVersion": "example",
  "caveats": [
    "example"
  ],
  "charged": true,
  "focus": {
    "source": "inferred"
  },
  "generatedAt": "2026-01-15T00:00:00.000Z",
  "kind": "practitioner_read",
  "permitMix": {
    "available": false,
    "coverage": "covered"
  },
  "persona": {
    "source": "caller"
  },
  "prose": "example",
  "questionUse": {
    "focusGroup": "records",
    "personaFrom": "question"
  },
  "readings": [
    {
      "checkNext": "example",
      "id": "example",
      "readingText": "example",
      "recordRefs": [
        "example"
      ],
      "status": "matched",
      "title": "example"
    }
  ],
  "readingsNotEvaluated": [
    {
      "id": "example",
      "reason": "example"
    }
  ],
  "recordRefs": [
    "example"
  ],
  "timing": {
    "recordsCached": false,
    "stages": {},
    "totalMs": 1
  },
  "verifyNext": [
    {
      "label": "example",
      "url": "https://example.gov/record"
    }
  ],
  "waterContext": {
    "citations": [
      "example"
    ],
    "nonInference": "example",
    "pfasDetectionCount": 1,
    "violationCount12mo": 1,
    "violations": [
      {}
    ]
  }
}