Developer API

Embed Global Procurement Into Any System

The AxBids REST API gives developers programmatic access to RFQ management, multi-round bidding, supplier data, landed cost calculations, and real-time freight rates. Build procurement automation directly into your ERP, WMS, or custom workflows.

REST API Webhooks OpenAPI 3.0 / Swagger OAuth 2.0 Rate Limits: 1000 req/min
Get API Key Free View Endpoints
JavaScript create-rfq.js 
// Create an RFQ and invite suppliers in one call
const response = await fetch('https://api.axbids.com/v1/rfqs', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    title: 'Steel Coil 3.0mm — Q3 2025',
    material_number: 'MAT-10293',
    quantity: 200,
    unit: 'MT',
    delivery_address: 'Houston, TX 77002',
    deadline: '2025-08-01',
    rounds: 3,
    bid_type: 'sealed',
    supplier_ids: ['sup_4821', 'sup_3307'],
    auto_landed_cost: true
  })
});

const { rfq_id, supplier_portal_url } = await response.json();
// rfq_id: "rfq_8a4f2c"
// supplier_portal_url: "https://bid.yourcompany.com/rfq_8a4f2c"
API Capabilities

Everything Available Over the API

📋

RFQ Management

Create, update, publish, and close RFQs programmatically. Set multi-round configurations, supplier lists, deadlines, and bid form requirements via API.

🏷️

Bid Collection & Analysis

Retrieve all bids for an RFQ in normalized format. Get AI scores, landed cost calculations, and rankings without logging into the UI.

🚢

Landed Cost Engine

Pass a supplier quote + origin country + destination ZIP + HS code and receive back a full landed cost breakdown in under 2 seconds.

📡

Real-Time Freight Rates

Query current ocean, air, and rail freight rates for any lane. Returns carrier rates, transit times, and surcharges in structured JSON.

🏭

Supplier Management

CRUD operations on your approved vendor list. Sync supplier records from your ERP, update contact info, and manage certifications programmatically.

🔔

Webhooks & Events

Subscribe to procurement events: bid submitted, round complete, RFQ deadline approaching, PO awarded. Push notifications to any endpoint.

🔗

ERP Push / Pull

Trigger bi-directional ERP sync via API. Push awarded POs, pull material master data, and sync vendor records on your own schedule.

📊

Analytics & Reports

Export savings reports, supplier scorecards, and bid histories in JSON or CSV. Feed procurement analytics into your own BI tools.

API Reference

Core Endpoints

Base URL: https://api.axbids.com/v1  ·  All requests require Bearer token.

RFQs

GET
/rfqs
List all active RFQs for your organization
POST
/rfqs
Create a new RFQ with supplier invitations
GET
/rfqs/{id}
Get full RFQ details including all bids and rounds
PUT
/rfqs/{id}
Update RFQ settings, extend deadlines, add suppliers
POST
/rfqs/{id}/rounds
Initiate a new bid round on an active RFQ
POST
/rfqs/{id}/award
Award the RFQ to a winning supplier

Bids

GET
/rfqs/{id}/bids
List all bids for an RFQ (all rounds)
GET
/rfqs/{id}/bids/{bid_id}
Get single bid with AI scoring and landed cost breakdown
POST
/rfqs/{id}/counter-offers
Issue counter-offer(s) to one or all suppliers

Landed Cost

POST
/landed-cost/calculate
Calculate landed cost for a unit price + origin + destination
GET
/freight-rates
Get current freight rates for a specified lane
GET
/tariffs
Lookup tariff and duty rates by HS code and origin country

Suppliers

GET
/suppliers
List all suppliers in your approved vendor list
POST
/suppliers
Add a new supplier to your vendor network
GET
/suppliers/{id}/history
Get a supplier's historical bid performance and scores

Webhooks

GET
/webhooks
List all configured webhook subscriptions
POST
/webhooks
Subscribe to a procurement event (bid.submitted, rfq.awarded, etc.)
DELETE
/webhooks/{id}
Remove a webhook subscription
Code Examples

Get Running in Minutes

Calculate Landed Cost
Pythonlanded_cost.py
import requests

result = requests.post(
    'https://api.axbids.com/v1/landed-cost/calculate',
    headers={'Authorization': f'Bearer {API_KEY}'},
    json={
        'unit_price': 794.00,
        'currency': 'USD',
        'origin_country': 'CN',
        'destination_zip': '77002',  # Houston TX
        'hs_code': '7209180010',
        'weight_kg': 1000,
        'transport_mode': 'ocean'
    }
)

data = result.json()
print(data['landed_cost_per_unit'])  # 847.00
print(data['tariff_amount'])          # 198.50
print(data['freight_amount'])         # 16.80
Webhook — Bid Submitted Event
JSONwebhook-payload.json
{
  "event": "bid.submitted",
  "rfq_id": "rfq_8a4f2c",
  "round": 2,
  "bid": {
    "id": "bid_3cc1f",
    "supplier_id": "sup_4821",
    "supplier_name": "Baosteel Intl.",
    "unit_price": 794.00,
    "currency": "USD",
    "landed_cost": 847.00,
    "ai_score": 91,
    "ai_rank": 1,
    "submitted_at": "2025-07-14T14:32:11Z"
  },
  "current_best_landed_cost": 847.00,
  "total_bids_received": 7
}
SDKs & Tools

Official Client Libraries

Official SDKs handle authentication, rate limiting, retries, and response parsing so you can focus on your integration logic.

Full OpenAPI 3.0 / Swagger specification available for auto-generating clients in any language. Interactive documentation available after account creation.

Node.js
npm install axbids
Python
pip install axbids
PHP
composer require axbids/sdk
Ruby
gem install axbids
.NET
NuGet AxBids.SDK
Java
Maven Central

API Access & Limits

Plan Req/Min Webhooks Sandbox
Free 60 3 ✓
Enterprise 1,000+ Unlimited ✓

A full sandbox environment with test suppliers, simulated bids, and mock freight data is available on all plans — including Free.

Get Your API Key Free

Need Integration Help?

Our US-based engineering team in Houston, TX provides dedicated API integration support for Enterprise customers. Free plan developers can access community docs and email support.

Get API Key Free Contact Engineering