NOX API

Programmatic access to quoting, ordering, and order tracking.

The NOX API is live. Request quotes, place orders, and track order status in real time, all from your own systems. Customers create and manage their own API keys in the customer portal.

Base URL & Authentication

All requests use HTTPS. Send JSON bodies for POST requests. Authenticate with your API key in either header:

# base URL
https://developer-api.noxmetals.co

# either of these headers
x-api-key: nox_live_xxxxxxxxxxxxxxxx
Authorization: Bearer nox_live_xxxxxxxxxxxxxxxx

Endpoints

Full request and response schemas are in the interactive OpenAPI docs at developer-api.noxmetals.co/api/docs.

Example Request

POST /api/v1/rfqs (requires a unique Idempotency-Key header)

{
  "job_number": "JOB-4471",
  "lines": [
    {
      "alloy": "6061",
      "temper": "T651",
      "thickness": 1.0,
      "width": 12.0,
      "length": 24.0,
      "requested_quantity": 5
    }
  ]
}

Example Response

202 Accepted

{
  "id": "1751eeef-…",
  "status": "pricing",
  "created_at": "2026-09-08T15:24:46Z",
  "poll_url": "/api/v1/rfqs/1751eeef-…"
}

Quoting is asynchronous: poll the returned URL until pricing_status is priced or failed. If pricing fails, inspect the error and stop polling. For a priced RFQ, lines in GET /api/v1/rfqs/{id} include availability and lead_time. Before purchasing, confirm every line has a positive total. Place the order with POST /api/v1/rfqs/{id}/purchase.

Get an API Key

API keys are self-served: sign in to the customer portal and create one under the API tab. The portal also carries the full endpoint reference with field-by-field request documentation.