place-an-order

curl -X POST https://api.skynet-docs.skynetparts.com/public/api/v1/b2b/orders \
  -H "Authorization: Bearer $SKYNET_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ACME-PO-4471-2026-06-03" \
  -d '{
    "items": [
      { "part_id": "skynet_part_BWxLDSfV6dFV5o40VwVTV0arE-5dVB7VE22Jd1bb40zYqKv2eI7lRPsBJGk0JleZRO1NI5VQz6qe7KifEy24PQGAL0bZbcE", "quantity": 10 }
    ],
    "po_number": "ACME-PO-4471",
    "notes": "Deliver to Hangar B"
  }'

const res = await fetch("https://api.skynet-docs.skynetparts.com/public/api/v1/b2b/orders", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.SKYNET_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "ACME-PO-4471-2026-06-03",
  },
  body: JSON.stringify({
    items: [
      {
        part_id: "skynet_part_BWxLDSfV6dFV5o40VwVTV0arE-5dVB7VE22Jd1bb40zYqKv2eI7lRPsBJGk0JleZRO1NI5VQz6qe7KifEy24PQGAL0bZbcE",
        quantity: 10,
      },
    ],
    po_number: "ACME-PO-4471",
    notes: "Deliver to Hangar B",
  }),
});
console.log(await res.json());

import os, requests

res = requests.post(
    "https://api.skynet-docs.skynetparts.com/public/api/v1/b2b/orders",
    headers={
        "Authorization": f"Bearer {os.environ['SKYNET_API_KEY']}",
        "Idempotency-Key": "ACME-PO-4471-2026-06-03",
    },
    json={
        "items": [
            {
                "part_id": "skynet_part_BWxLDSfV6dFV5o40VwVTV0arE-5dVB7VE22Jd1bb40zYqKv2eI7lRPsBJGk0JleZRO1NI5VQz6qe7KifEy24PQGAL0bZbcE",
                "quantity": 10,
            }
        ],
        "po_number": "ACME-PO-4471",
        "notes": "Deliver to Hangar B",
    },
)
print(res.json())

{
  "success": true,
  "order": {
    "order_id": "skynet_order_8f2a1c",
    "status": "open",
    "po_number": "ACME-PO-4471",
    "line_items": [
      {
        "part_number": "MS21042L3",
        "title": "Self-Locking Nut, MS21042L3",
        "quantity": 10,
        "unit_price": { "amount": "11.16", "currency": "USD" },
        "line_total": { "amount": "111.60", "currency": "USD" }
      }
    ],
    "subtotal": { "amount": "111.60", "currency": "USD" },
    "created_at": "2026-06-03T14:30:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_INVENTORY",
    "message": "One or more items don't have enough stock.",
    "details": {
      "items": [
        {
          "part_number": "MS21042L3",
          "requested": 10,
          "available": 3
        }
      ]
    }
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Authorization header missing or malformed."
  }
}

Send a list of parts and quantities along with your PO number. The response confirms the order, your real B2B prices, and the total.

POST https://api.skynet-docs.skynetparts.com/public/api/v1/b2b/orders

Requires an API key. See Authentication for how to get one.

Always send a unique Idempotency-Key header. Without one, a network retry could create a duplicate order.

Headers

Header	Required	Value
`Authorization`	Yes	`Bearer sk_live_...`
`Content-Type`	Yes	`application/json`
`Idempotency-Key`	Yes	A unique string per order.

About `Idempotency-Key`

A unique string you make up for each order anything you want, like your PO number plus today’s date. If your network drops and you retry the same request with the same Idempotency-Key, we return the original order instead of creating a duplicate. Always send one.

Body

object[]

required

The parts to order. At least one entry.

string

required

From the Look Up Parts response.

integer

required

Positive integer.

string

required

Your internal purchase order number.

string

Free-text note that appears on the order paperwork.

curl -X POST https://api.skynet-docs.skynetparts.com/public/api/v1/b2b/orders \
  -H "Authorization: Bearer $SKYNET_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ACME-PO-4471-2026-06-03" \
  -d '{
    "items": [
      { "part_id": "skynet_part_BWxLDSfV6dFV5o40VwVTV0arE-5dVB7VE22Jd1bb40zYqKv2eI7lRPsBJGk0JleZRO1NI5VQz6qe7KifEy24PQGAL0bZbcE", "quantity": 10 }
    ],
    "po_number": "ACME-PO-4471",
    "notes": "Deliver to Hangar B"
  }'

const res = await fetch("https://api.skynet-docs.skynetparts.com/public/api/v1/b2b/orders", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.SKYNET_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "ACME-PO-4471-2026-06-03",
  },
  body: JSON.stringify({
    items: [
      {
        part_id: "skynet_part_BWxLDSfV6dFV5o40VwVTV0arE-5dVB7VE22Jd1bb40zYqKv2eI7lRPsBJGk0JleZRO1NI5VQz6qe7KifEy24PQGAL0bZbcE",
        quantity: 10,
      },
    ],
    po_number: "ACME-PO-4471",
    notes: "Deliver to Hangar B",
  }),
});
console.log(await res.json());

import os, requests

res = requests.post(
    "https://api.skynet-docs.skynetparts.com/public/api/v1/b2b/orders",
    headers={
        "Authorization": f"Bearer {os.environ['SKYNET_API_KEY']}",
        "Idempotency-Key": "ACME-PO-4471-2026-06-03",
    },
    json={
        "items": [
            {
                "part_id": "skynet_part_BWxLDSfV6dFV5o40VwVTV0arE-5dVB7VE22Jd1bb40zYqKv2eI7lRPsBJGk0JleZRO1NI5VQz6qe7KifEy24PQGAL0bZbcE",
                "quantity": 10,
            }
        ],
        "po_number": "ACME-PO-4471",
        "notes": "Deliver to Hangar B",
    },
)
print(res.json())

curl -X POST https://api.skynet-docs.skynetparts.com/public/api/v1/b2b/orders \
  -H "Authorization: Bearer $SKYNET_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ACME-PO-4471-2026-06-03" \
  -d '{
    "items": [
      { "part_id": "skynet_part_AAA...", "quantity": 10 },
      { "part_id": "skynet_part_BBB...", "quantity": 4 }
    ],
    "po_number": "ACME-PO-4471"
  }'

{
  "success": true,
  "order": {
    "order_id": "skynet_order_8f2a1c",
    "status": "open",
    "po_number": "ACME-PO-4471",
    "line_items": [
      {
        "part_number": "MS21042L3",
        "title": "Self-Locking Nut, MS21042L3",
        "quantity": 10,
        "unit_price": { "amount": "11.16", "currency": "USD" },
        "line_total": { "amount": "111.60", "currency": "USD" }
      }
    ],
    "subtotal": { "amount": "111.60", "currency": "USD" },
    "created_at": "2026-06-03T14:30:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_INVENTORY",
    "message": "One or more items don't have enough stock.",
    "details": {
      "items": [
        {
          "part_number": "MS21042L3",
          "requested": 10,
          "available": 3
        }
      ]
    }
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Authorization header missing or malformed."
  }
}

Response fields

boolean

true when the order is created.

string

An opaque order ID. Use this when contacting support about an order.

string

open means the order has been placed on your account’s Net payment terms (unpaid until invoiced) and appears under Orders in your Skynet B2B account, pending fulfillment.

string

Your internal PO number, echoed back from the request.

object[]

One entry per item you ordered. Note: line_items do not include the part_id from your request once an order is placed, you reference it by order_id and po_number, not by individual part.

string

The manufacturer part number for this line.

string

Human-readable name for the part.

integer

Units ordered on this line.

object

The price you actually pay per unit. This is your B2B price for this part may be lower than the catalog price shown when you looked up the part. Contains amount and currency.

object

unit_price × quantity for this line. Contains amount and currency.

object

The sum of all line_total values. Final invoice may include tax, shipping, and other adjustments depending on your account terms.

string

ISO 8601 UTC timestamp.

Errors

These codes apply to this endpoint:

Code	HTTP	Meaning
`VALIDATION_FAILED`	400	Body is missing a field or has the wrong type.
`INVALID_PART_TOKEN`	400	A `part_id` you sent isn’t recognized. Look up the part again.
`INVALID_API_KEY`	401	Your API key is missing, malformed, or wrong.
`KEY_REVOKED`	401	The key was revoked. Email info@skynetparts.com for a replacement.
`INSUFFICIENT_INVENTORY`	409	One or more items don’t have enough stock. Response lists which.
`IDEMPOTENCY_CONFLICT`	409	You sent an `Idempotency-Key` we’ve already seen, but with a different order body.
`IDEMPOTENCY_IN_PROGRESS`	409	A request with this `Idempotency-Key` is still being processed. Retry shortly.
`ORDER_FAILED`	502	Order placement failed on our end. Your order was not placed. Safe to retry.

See Error codes for the full list and response shape.

Get Started

API

Reference

place-an-order

Headers

About `Idempotency-Key`

Body

Response fields

Errors

​Headers

​About Idempotency-Key

​Body

​Response fields

​Errors

Headers

About `Idempotency-Key`

Body

Response fields

Errors