API
Order through the API
The same flow as the website for your own tools, ERP or agents: create a request, get a quote, accept it, and track delivery. JSON over HTTPS with a bearer key.
Endpoints
- GET/api/v1/categoriesServices and the fields each request takes.
- GET/api/v1/suppliers?site=&category=&q=&cert=The directory: search, filter and page through listings.
- POST/api/v1/uploadsUpload a file; put the returned link in a request field.
- POST/api/v1/requestsCreate a request, optionally with the suppliers you picked. Idempotency-Key supported.
- GET/api/v1/requestsRequests created with your key.
- GET/api/v1/requests/{id}Status, quotes, timeline and delivered files.
- GET/api/v1/requests/{id}/eventsThe timeline only, optionally since a time.
- POST/api/v1/requests/{id}/messagesAnswer a question or add detail.
- POST/api/v1/requests/{id}/cancelCancel before payment.
- POST/api/v1/quotes/{id}/acceptAccept a quote. Returns a card payment link when available.
- PUT/api/v1/webhookReceive signed callbacks when a request changes.
- GET/api/v1/openapi.jsonOpenAPI 3.1 description.
Create a request
curl -X POST https://midgardindustrial.aramous.com/api/v1/requests \
-H "Authorization: Bearer sk_live_..." \
-H "Idempotency-Key: my-order-123" \
-H "Content-Type: application/json" \
-d '{
"site": "industrial",
"category": "cnc-machining",
"title": "CNC machining request",
"spec": {
"material": "…",
"finish": "…"
},
"quantity": 10,
"needed_by": "2027-01-15"
}'Statuses: new → sourcing → quoted → accepted → paid → in_progress → delivered. Poll the request or set a webhook; when status is quoted, accept the quote in quotes[0]. Errors return {"error": {"code", "message"}}. Limit: 120 requests per minute per key.
Get a key
Shown once. Requests made with it are tied to this email.