Buy from Big Sky Dynamics with code, not phone calls

Overview

The partner API covers the whole buy path you would otherwise do by email: search the catalog, get your price and availability, create a quote, convert it to an order, then pull order status, EDI payloads and PDF documents.

Base URL: https://portal.bsdyno.com/api — the same host as this site, same TLS certificate, no separate hostname to allowlist.

• Catalog, price and availability: read-only, safe to poll.
• Quotes: create and convert; quotes are valid 30 days.
• Orders: status, tracking, ASN and invoice/PO PDFs.
• EDI: 850 inbound, 855/856/810 outbound, 997 acknowledgements.

Authentication

Send your key in the X-API-Key header. Authorization: Bearer <key> is accepted too.

curl -s https://portal.bsdyno.com/api/catalog?q=GPU&limit=1 \
  -H "X-API-Key: $BSD_API_KEY"

• Keys are scoped per customer account, not per user — rotate them in the account area or by asking us.
• Create a second key before you retire the first so nothing breaks mid-rotation.
• Keys are never sent to a browser; the portal itself keeps them server-side.
• A request without a key, or with a wrong key, gets 401 auth_required.

Conventions

• JSON in, JSON out; Content-Type: application/json on every POST.
• Money appears twice: unit_price_cents (integer, exact) and unit_price (decimal, display). Use the cents field for arithmetic.
• Timestamps are ISO-8601 UTC.
• Ids are opaque strings (Q-20261107-0005, O-20261107-0004, DOC-20261107-0007). Never parse them.
• Errors are always {"error": {"code": "...", "message": "..."}}.

Endpoints

Order and document lookups additionally require the buyer email on the order (?email=). That is deliberate: order ids are sequential, so a bare id must never be enough to read someone else’s order.

Pricing & contract rates

/price prices one SKU at one quantity with the same engine that writes your quotes, and returns every channel:

{
  "sku": "33P01IB0BB",
  "quantity": 1,
  "channel": "partner",
  "unit_price_cents": 201399,
  "channels": {
    "list":      { "unit_price_cents": 201399 },
    "partner":   { "unit_price_cents": 201399 },
    "wholesale": { "unit_price_cents": 201399 },
    "gov":       { "unit_price_cents": 201399 },
    "edu":       { "unit_price_cents": 201399 }
  },
  "pricing_trail": [ ... ],
  "as_of": "2026-11-08T13:35:38+00:00"
}

• partner is your contract channel; list is the public price.
• The portal price-list page shows both side by side and exports them as CSV.
• A special price authorization on your account overrides the channel price and applies automatically to quotes.
• Quantity breaks are priced per line: send the quantity you intend to buy.

Quotes → orders

curl -s -X POST https://portal.bsdyno.com/api/quote \
  -H "X-API-Key: $BSD_API_KEY" -H "Content-Type: application/json" \
  -d '{"items":[{"sku":"33P01IB0BB","qty":8}],"terms":"net30",
       "customer":{"name":"Buyer","email":"[email protected]"}}'

curl -s -X POST https://portal.bsdyno.com/api/quote/Q-20261107-0005/convert \
  -H "X-API-Key: $BSD_API_KEY" -H "Content-Type: application/json" \
  -d '{"po_number":"PO-12345"}'

• Quotes are valid 30 days; an expired or already-converted quote returns 409.
• Anonymous quote creation from the public site is rate limited; API key calls carry your account identity.
• The convert response is the order, including its id for later status and documents.

Orders & documents

curl -s "https://portal.bsdyno.com/api/orders/[email protected]" \
  -H "X-API-Key: $BSD_API_KEY"

curl -s -X POST "https://portal.bsdyno.com/api/documents/order/[email protected]" \
  -H "X-API-Key: $BSD_API_KEY" -H "Content-Type: application/json" \
  -d '{"kinds":["invoice"]}'

Document rendering is idempotent: calling it twice for the same order and kind returns the same document id. Every issued document records a SHA-256 of both renditions, and the ?v= token in its URL is that hash prefix — so a link cannot be pointed at another document.

EDI 850 / 855 / 856 / 810

X12 004010. Test and production are separated by the ISA usage indicator (T / P); ISA/GS qualifiers and ids are issued to you at onboarding.

Also supported by the same registry: 846 (inventory inquiry) and 832 (price/sales catalog). Envelope: ISA · GS · ST · SE · GE · IEA. Transport: AS2 (signed, MDN) preferred, SFTP with PGP on request. Test payloads before production — we will send you a test 850 and confirm the 997.

Errors & limits

• Anonymous quote creation: 3 per 5 minutes and 10 per hour per client IP.
• Catalog, price and availability: poll no faster than once per second per key.
• Document generation is idempotent and cached — safe to retry.

Go-live checklist

1. Send us your use case (quote automation, price sync, drop-ship, EDI).
2. We provision your account, contract price list and API key.
3. If EDI: we agree ISA/GS ids, transport (AS2 or SFTP) and test vs production.
4. Run a test quote, convert it to a test order and pull the invoice PDF in our sandbox.
5. Exchange one test 850 → 855 and one 856, and confirm the 997 in both directions.
6. Go live; we watch the first 48 hours with you.