P&ID Extraction API: Upload Drawings, Get Structured I/O Data

The web app works well for one-off extractions. But if you're processing drawings regularly or feeding I/O data into another system, copying results out of a browser doesn't scale.

So we built an API.

The short version

Upload a PDF, poll for results (or get a webhook), download structured instrument data. Four endpoints:

• POST /v1/extract — upload a drawing
• GET /v1/jobs — list your extraction jobs
• GET /v1/jobs/{id} — check status
• GET /v1/jobs/{id}/results — get the instruments

You get back tag numbers, signal classes, descriptions, confidence scores — same data as the web app, in JSON.

Auth

API keys live in your dashboard. Each key gets scoped permissions (extract, read) and an optional expiry. If you need to rotate a key, there's an atomic rotation endpoint — new key created, old key revoked, one call.

Webhooks

Polling works, but if you'd rather not: register a webhook URL, and we'll POST to it when an extraction finishes or fails. Payloads are cryptographically signed. Failed deliveries retry automatically.

Seven export formats

Depending on what's downstream, you can pull results as:

1. Excel — formatted, conditional formatting, audit trail
2. CSV — plain, injection-safe
3. PLCCreator — Device IO List format, ready for PLC import
4. JSON — everything, machine-readable
5. TIA Portal XML — Siemens GlobalDB block with S7-1200/1500 I/O tags
6. Rockwell L5X — Studio 5000 importable tags for Allen-Bradley PLCs
7. DEXPI XML — ISO 15926-based format for process industry data exchange

Bluebeam integration

If you work in Bluebeam Max, there's a desktop plugin that uses the same API under the hood. Extract directly from Bluebeam without opening a browser. More on that here.

Get started

Every account comes with 5 free pages. Create an API key from your dashboard, and check the developer docs for the full reference.

If there's a format or integration you need, tell us.