Extract site instructions API

Extract dates, issuers, locations, referenced activities, and change flags from supplied site instructions.

The Extract site instructions operation is part of the Construction Site Operations API on BRAINIAC.software. Extract dates, issuers, locations, referenced activities, and change flags from supplied site instructions. It is exposed as POST /api/v1/construction-site-operations/instruction-extract and priced at $0.04 USDC on Base. Payment uses the x402 exact scheme: an unpaid call returns HTTP 402 with payment requirements; after paying the exact USDC amount, retry the same request with a payment-signature header and Idempotency-Key. No account and no API key are required. Data sources for this product: Caller-supplied daily reports Baseline and actual schedules RFIs Site instructions Delivery records Limitations: Dates, parties, and quantities are copied only from labeled fields. Recorded events are distinguished from inferred schedule impact. Delays, entitlements, and liability are never invented or decided. Unresolved RFIs and missing deliveries use supplied due/expected dates only. No construction account or project system is accessed. Outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Related operations in this group include Parse construction daily reports, Analyze site progress, Detect construction delay events, Track requests for information. Open the group documentation for the full request schema, field notes, and response examples before integrating.

POST$0.04 USDC
/api/v1/construction-site-operations/instruction-extract

Example request

curl -i -X POST "https://www.brainiac.software/api/v1/construction-site-operations/instruction-extract" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "activities": [
    {
      "id": "A-2",
      "name": "Frame"
    }
  ],
  "instructions": [
    {
      "id": "SI-1",
      "date": "2026-11-04",
      "issuer": "Architect",
      "location": "Level 2",
      "activityId": "A-2",
      "change": true,
      "text": "Change window opening size on Level 2 Frame"
    },
    {
      "id": "SI-2",
      "date": "2026-11-05",
      "issuer": "PM",
      "text": "Confirm access route remains clear"
    }
  ]
}
JSON

An unpaid probe returns HTTP 402 with x402 payment requirements. After paying the exact USDC amount on Base, retry the identical request with a payment-signature header.

FAQ

  • Do I need an API key? No. Pay the listed USDC amount with x402.
  • What network? Base (eip155:8453), USDC.
  • Is this an official determination? No. Results are for human review against the cited sources.

Related APIs

Construction Site Operations APIFull docsHow it works