catalog

curl -X POST https://api.skynet-docs.skynetparts.com/public/api/v1/b2b/catalog \
  -H "Authorization: Bearer $SKYNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "part_numbers": ["MS21042L3", "AN3-5A"] }'

const res = await fetch("https://api.skynetparts.com/public/api/v1/b2b/catalog", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.SKYNET_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ part_numbers: ["MS21042L3", "AN3-5A"] }),
});
console.log(await res.json());

import os, requests

res = requests.post(
    "https://api.skynetparts.com/public/api/v1/b2b/catalog",
    headers={"Authorization": f"Bearer {os.environ['SKYNET_API_KEY']}"},
    json={"part_numbers": ["MS21042L3", "AN3-5A"]},
)
print(res.json())

{
  "success": true,
  "found_parts": [
    {
      "part_id": "skynet_part_BWxLDSfV6dFV5o40VwVTV0arE-5dVB7VE22Jd1bb40zYqKv2eI7lRPsBJGk0JleZRO1NI5VQz6qe7KifEy24PQGAL0bZbcE",
      "part_number": "MS21042L3",
      "part_name": "Self-Locking Nut",
      "title": "Self-Locking Nut, MS21042L3",
      "description": "COVER: CUSHION, ASSEMBLY",
      "condition": "NE",
      "unit_of_measure": "EA",
      "available_stock": 87,
      "price": { "amount": "12.40", "currency": "USD" },
      "status": "ACTIVE"
    }
  ],
  "not_found": ["AN3-5A"],
  "summary": { "total_requested": 2, "found": 1, "not_found": 1 }
}

{
  "success": true,
  "found_parts": [],
  "not_found": ["XYZ-999", "ABC-000"],
  "summary": { "total_requested": 2, "found": 0, "not_found": 2 }
}

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

Send a list of part numbers or part names, get back stock, our catalog price and an ID you can use to order each one. Up to 50 parts per request.

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

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

Headers

Header	Required	Value
`Authorization`	Yes	`Bearer sk_live_...`
`Content-Type`	Yes	`application/json`

Body

string[]

List of manufacturer part numbers most reliable.

string[]

List of part names or descriptions use when you don’t have the exact number.

boolean

default:"false"

When true, only parts with stock on hand (available_stock > 0) are returned. Defaults to false (all matches).

Send at least one of the two arrays. You may send both results merge. Maximum 50 entries total.

curl -X POST https://api.skynet-docs.skynetparts.com/public/api/v1/b2b/catalog \
  -H "Authorization: Bearer $SKYNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "part_numbers": ["MS21042L3", "AN3-5A"] }'

const res = await fetch("https://api.skynetparts.com/public/api/v1/b2b/catalog", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.SKYNET_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ part_numbers: ["MS21042L3", "AN3-5A"] }),
});
console.log(await res.json());

import os, requests

res = requests.post(
    "https://api.skynetparts.com/public/api/v1/b2b/catalog",
    headers={"Authorization": f"Bearer {os.environ['SKYNET_API_KEY']}"},
    json={"part_numbers": ["MS21042L3", "AN3-5A"]},
)
print(res.json())

curl -X POST https://api.skynet-docs.skynetparts.com/public/api/v1/b2b/catalog \
  -H "Authorization: Bearer $SKYNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "part_names": ["Self-Locking Nut", "Cotter Pin"] }'

curl -X POST https://api.skynet-docs.skynetparts.com/public/api/v1/b2b/catalog \
  -H "Authorization: Bearer $SKYNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "part_numbers": ["MS21042L3"], "part_names": ["Cotter Pin"] }'

curl -X POST https://api.skynet-docs.skynetparts.com/public/api/v1/b2b/catalog \
  -H "Authorization: Bearer $SKYNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "part_numbers": ["MS21042L3"], "in_stock": true }'

{
  "success": true,
  "found_parts": [
    {
      "part_id": "skynet_part_BWxLDSfV6dFV5o40VwVTV0arE-5dVB7VE22Jd1bb40zYqKv2eI7lRPsBJGk0JleZRO1NI5VQz6qe7KifEy24PQGAL0bZbcE",
      "part_number": "MS21042L3",
      "part_name": "Self-Locking Nut",
      "title": "Self-Locking Nut, MS21042L3",
      "description": "COVER: CUSHION, ASSEMBLY",
      "condition": "NE",
      "unit_of_measure": "EA",
      "available_stock": 87,
      "price": { "amount": "12.40", "currency": "USD" },
      "status": "ACTIVE"
    }
  ],
  "not_found": ["AN3-5A"],
  "summary": { "total_requested": 2, "found": 1, "not_found": 1 }
}

{
  "success": true,
  "found_parts": [],
  "not_found": ["XYZ-999", "ABC-000"],
  "summary": { "total_requested": 2, "found": 0, "not_found": 2 }
}

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

Response fields

boolean

true for any 200 response including responses where every part landed in not_found.

object[]

One entry per part that matched. Empty array if nothing matched.

string

An opaque ID for the part. Use it when placing an order. Safe to log. Look up the part again if you haven’t ordered within an hour.

string

The manufacturer part number.

string

The part name from our catalog metadata.

string

The part description. Attributes like condition and unit of measure are returned as their own fields below, not inside the description.

string

Condition code for the part (e.g. NE new, OH overhauled, SV serviceable).

string

Unit the part is sold in (e.g. EA each).

string

Human-readable name for the part.

integer

Units currently on hand.

object

Our list catalog price for this part. Your account may have a negotiated B2B price that’s different the order response always shows your actual unit_price. Contains amount (string, decimal) and currency (string, ISO code).

string

Lifecycle marker for the part. ACTIVE means it can be ordered.

string[]

The exact part numbers or part names from your request that didn’t match anything in our catalog. Returned as a successful response (success=true), not an error partial matches are normal when sending many parts at once.

object

Counts for the request. Contains total_requested, found, and not_found integers.

Our catalog price is shown here. Your B2B account may have negotiated lower pricing — your actual unit price is confirmed when you place the order.

Errors

These codes apply to this endpoint:

Code	HTTP	Meaning
`VALIDATION_FAILED`	400	Body is missing a field or has the wrong type.
`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.
`UPSTREAM_ERROR`	502	Catalog lookup failed on our end. Safe to retry.

See Error codes for the full list and response shape.

Get Started

API

Reference

Headers

Body

Response fields

Errors

​Headers

​Body

​Response fields

​Errors

Headers

Body

Response fields

Errors