Documentation

Netract API reference

Netract's three pipelines, the Inbound Procurement Gateway, the Omni-Channel Orchestration Engine, and the Compliance Passport Compiler, are available programmatically. Requests are JSON over HTTPS, authenticated with an organization API key, and writes are idempotent on your supplied reference. The Omni-Channel Orchestration Engine only ever extracts activity metadata from the tools your team already uses, engineering pipelines (GitHub, GitLab, Bitbucket), agile frameworks (Jira, Linear, Asana), creative workspaces (Figma, Miro, G-Suite) and a SHA-256 checksum fallback node. It never reads or parses proprietary code, designs or documents, and no milestone clears without manual enterprise sign-off.

Authentication

curl https://api.netract.io/api/public/v1/invoices \
  -H "Authorization: Bearer ntr_live_••••••••" \
  -H "Content-Type: application/json" \
  -d '{ "clientName": "Northwind Labs Inc.", "currency": "USD", "amount": 42000 }'

Endpoints

POST/api/public/v1/invoicesInbound Procurement Gateway

Create a procurement invoice

White-labeled developer invoicing API, authenticated with a Developer API key. Captures Western corporate invoice inputs and reserves a collection reference on the Verispect Ltd UK collection layout.

Request

{
  "clientName": "Northwind Labs Inc.",
  "clientEmail": "ap@northwindlabs.com",
  "clientCountryCode": "US",
  "currency": "USD",
  "amount": 42000.00,
  "description": "Platform engineering retainer, March"
}

Response

{
  "id": "inv_9c1f4ad2",
  "invoice_number": "INV-2041",
  "status": "SENT",
  "collection_reference": "NTR-8F42-2041",
  "merchant_of_record": "Verispect Ltd (UK)"
}

POST/api/public/v1/compliance/ledgerOmni-Channel Orchestration Engine

Unified activity ingestion port

Single signed ingestion port for every production ecosystem: ENGINEERING (GitHub, GitLab, Bitbucket), AGILE (Jira, Linear, Asana), CREATIVE (Figma, Miro, G-Suite) and CHECKSUM (SHA-256 of an uploaded performance artifact for legacy workflows). HMAC-SHA256 signed over the raw body, idempotent per fingerprint. Metadata only, no code, design or document content is read, and ingestion never approves a milestone.

Request

POST /api/public/v1/compliance/ledger
x-netract-signature: sha256=<hex hmac of raw body>
content-type: application/json

{
  "collection_reference": "NTR-8F42-2041",
  "channel": "AGILE",
  "source_system": "JIRA",
  "payload": {
    "issue": { "key": "NTR-418" },
    "status_from": "In Review",
    "status_to": "Done",
    "transitioned_at": "2026-03-30T09:12:00Z",
    "actor": "product.director"
  }
}

Response

{
  "ok": true,
  "engine": "NETRACT-OMNI-CHANNEL-1.0",
  "intake_principle": "METADATA_ONLY_NO_ASSET_INGESTION",
  "custody_model": "ZERO_CUSTODY_ZERO_FLOAT",
  "channel": "AGILE",
  "source_system": "JIRA",
  "recorded": 1,
  "approvalRequired": true
}

POST/api/public/milestones/clear-invoiceInbound Procurement Gateway

Inbound settlement webhook

Called by the Tier-1 licensed banking partner (Airwallex/Wise) when a Western corporate client settles a SEPA Instant / Faster Payments / Fedwire transfer into a Verispect Ltd UK virtual account. HMAC-SHA256 signed, idempotent, and notifies your webhook array on success.

Request

POST /api/public/milestones/clear-invoice
x-signature: sha256=<hex hmac of raw body>
content-type: application/json

{
  "event": "payment.settled",
  "provider": "airwallex",
  "collection_reference": "NTR-8F42-2041",
  "currency": "USD",
  "amount": 42000.00,
  "settlement_rail": "sepa_instant",
  "occurred_at": "2026-03-31T14:02:11Z"
}

Response

{
  "received": true,
  "invoice_status": "PAID",
  "buyer_platform_fee": "0.00%"
}

POST/api/withdrawals/forex-bankOutbound Treasury Routing

Route cleared funds to a Foreign Currency Retention Account

Final-mile distribution executed exclusively by the licensed banking partner into the contractor's formal local bank Foreign Currency Retention Account, or for direct international B2B SaaS bill clearing. Captures the flat 2.50% supplier settlement fee, charged only on clearing. Netract never custodies these funds.

Request

{
  "asset": "USD",
  "amount": 9000.00,
  "destinationId": "8e2c1a10-4f3b-4a9e-9c11-2f0b6a441d2e",
  "purposeCode": "SERVICE_EXPORT_PROCEEDS"
}

Response

{
  "status": "accepted",
  "settlement_fee": "2.50%",
  "channel": "FOREX_RETENTION_ACCOUNT",
  "provider_reference": "AWXPAY-8842K"
}

POST/api/compliance/generate-passportCompliance Passport Compiler

Generate a Compliance Passport

Compiles agreement metadata, Omni-Channel Orchestration Engine attestation (verified commits, PR links, timestamps, human client sign-off) and cleared procurement ledger entries into an unalterable, cryptographically signed PDF/JSON audit trail for a bank compliance desk.

Request

{
  "agreementId": "5b7c9e10-1a2b-4c3d-8e4f-9a0b1c2d3e4f",
  "periodStart": "2026-03-01",
  "periodEnd": "2026-03-31"
}

Response

{
  "compliance_node": "passport_5518qa",
  "merchant_of_record": "Verispect Ltd (UK)",
  "subcontractor_id": "sub_44a1",
  "audit_trail": {
    "git_repository": "northwind/platform-engineering",
    "verified_commits": [
      { "sha": "a1b2c3d", "timestamp": "2026-03-30T09:12:00Z" }
    ],
    "human_client_signoff": true
  },
  "buyer_platform_fee": "0.00%"
}

Compliance state machine

State	Meaning
DRAFT	Created, not yet issued to the corporate client.
SENT	Issued with an active collection reference and tracking link.
PAID	Settled in full via the Inbound Procurement Gateway; the buyer pays no platform fee and the 2.50% supplier settlement fee is recorded.
ROUTED	Outbound Treasury Routing Spread applied; funds distributed by the banking partner into the contractor's Foreign Currency Retention Account or B2B vendor bill clearing.
PASSPORT_ISSUED	Compliance Passport Compiler has produced the unalterable PDF/JSON audit trail for the agreement.

Get API access KYB requirements