# EDIBridge Transform API

> Structure-aware transform API for business CSV, JSON, and X12 EDI. Five directions live: csv↔json, csv→x12, x12→json, json→x12 (810/856/997/850 via documentType). Retailer-profile validation live with 10 free validates per IP per day. MCP + OpenAPI live. Pay-per-use pricing, no monthly minimums.

Operated by Tebco Mining LLC d/b/a EDIBridge. Full EDI SaaS for suppliers: https://edibridge.com

## Live now

- GET /v1/health — lists supported_directions
- POST /v1/transform?from=&to= — csv→json, json→csv, csv→x12, x12→json, json→x12 ($0.05/document at launch)
- POST /v1/validate?profile=walmart — fatal/warning/info findings ($0.25/file, 10 free/day per IP); 18 documented finding codes
- GET /v1/openapi.json — OpenAPI 3.1 spec (drift-tested against engine)
- POST /mcp — MCP tools transform_document, validate_edi (Streamable HTTP)

API base: https://transform.edibridge.com/v1
MCP: https://transform.edibridge.com/mcp
OpenAPI: https://transform.edibridge.com/v1/openapi.json
Landing: https://transform.edibridge.com
Docs: https://transform.edibridge.com/docs/

## Docs (copy-paste curls)

- https://transform.edibridge.com/docs/csv-to-json
- https://transform.edibridge.com/docs/json-to-csv
- https://transform.edibridge.com/docs/x12-to-json
- https://transform.edibridge.com/docs/validate

## Example curls

### CSV → JSON

```
curl -sS -X POST 'https://transform.edibridge.com/v1/transform?from=csv&to=json' \
  -H 'content-type: text/csv' \
  --data-binary @- <<'CSV'
PO_Number,Order_Date,Ship_To_Name,Ship_To_Address,Ship_To_City,Ship_To_State,Ship_To_Zip,Item_UPC,Item_Description,Quantity,Unit_Price,Unit_Of_Measure
DEMO001,2026-07-01,Demo Store,100 Main St,Austin,TX,78701,012345678901,Demo Widget,12,9.99,EA
CSV
```

### JSON → CSV

```
curl -sS -X POST 'https://transform.edibridge.com/v1/transform?from=json&to=csv' \
  -H 'content-type: application/json' \
  -d '{"poNumber":"DEMO001","poDate":"20260701","parties":[{"entityCode":"ST","name":"Demo Store","address1":"100 Main St","city":"Austin","state":"TX","zip":"78701"}],"lineItems":[{"lineNumber":"1","quantityOrdered":12,"unitOfMeasure":"EA","unitPrice":9.99,"upc":"012345678901","description":"Demo Widget"}]}'
```

### Validate (Walmart profile)

```
curl -sS -X POST 'https://transform.edibridge.com/v1/validate?profile=walmart' \
  -H 'content-type: text/plain' \
  --data-binary @path/to/850.edi
```

## CSV v1 contract (stateless public lane)

PO_Number, Order_Date, Ship_To_Name, Ship_To_Address, Ship_To_City, Ship_To_State, Ship_To_Zip, Item_UPC, Item_Description, Quantity, Unit_Price, Unit_Of_Measure

## MCP tools

- transform_document — from/to/document; launch $0.05/doc (free preview)
- validate_edi — document + optional profile=walmart; launch $0.25/file, 10 free/day/IP (free preview)

## Coming soon

- POST /v1/map — AI field mapping ($0.75/call)
- XML and flat-file directions
- Stripe prepaid credit packs (meter billing)