Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: SMKlog Quote Price Index API
version: 1.5.0
summary: Live parcel rates from a US origin, a checkout handed to a human, and where that checkout stands.
description: 'Live parcel rates from USPS, UPS, FedEx and DHL Express for a single shipment sent from a US origin: inside the US, or to Canada, the UK, Germany or Australia. Describe the item in plain words and the packed box size and weight are estimated server-side; supply exact dimensions and weight to skip the estimate. No account and no key: only a create-or-update keyed on your own external_id, or a session write that carries an Idempotency-Key, needs a bearer token, from an OAuth client any agent registers itself at /oauth/register. Rate limited per client (about 80 quote requests per hour); quotes cost real money to produce, so cache on your side and do not poll. Buying a label happens on smklog.com — this API prices and hands the payment to a human, it does not sell. It also tracks labels bought on smklog.com, reports whether a label payment was refunded, serves the monthly parcel shipping price index, works out the billable (dimensional) weight of a box, and lists the carriers’ holiday send-by dates and SMKlog’s shipping restrictions.'
termsOfService: https://smklog.com/terms
contact:
name: SMKlog
email: info@smklog.com
url: https://smklog.com/developers/
x-publisher: SMKlog (SMKLOG-2022 LLC)
servers:
- url: https://quote-api.smklog.com
description: 'Production. There is no sandbox host: quoting is free and read-only, so production is the place to try it.'
security:
- {}
- clientCredentials:
- quote
tags:
- name: Price Index
description: 'Parcel price benchmark data: the monthly SMKlog parcel shipping price index, what six common boxes cost to ship from Newark, NJ to five US cities with every service quoted, published as open data (CC BY 4.0).'
paths:
/price-index:
get:
operationId: getPriceIndex
tags:
- Price Index
x-agentic-access:
action-class: connected
consequence: read
subject: optional
audience: https://quote-api.smklog.com
token:
max-ttl: 3600
audit: none
summary: Read the monthly US parcel shipping price index
description: 'The SMKlog parcel shipping price index: a basket of six common boxes (1 to 20 lb) shipped from Newark, NJ to five US cities, repriced every month through the same live USPS, UPS and FedEx pipeline that prices real shipments. Each cell is the cheapest purchasable checkout total with every service behind it, and each price is a checkout total with the SMKlog fee inside. Published as open data: the same checkout totals are on the issue pages and in the CC BY 4.0 dataset. Reference data for questions like "what does shipping a shoebox cost in the US right now"; for one specific shipment call getParcelQuote. month picks an issue (YYYY-MM, from 2026-07 on) and its absence returns the newest; a month with no issue answers 404 issue_not_found with available_months, so one miss lists every valid value. The REST twin of the get_price_index MCP tool: a read of published data, no carrier call and no quote allowance, 25 reads an hour per client.'
parameters:
- name: month
in: query
required: false
schema:
type: string
pattern: ^[0-9]{4}-[0-9]{2}$
description: Issue month as YYYY-MM. Omit for the newest published issue.
example: 2026-10
responses:
'200':
description: 'The issue: month, label, captured_on, origin, basket_average, carrier_wins, cells (box, dims, weight, to, to_zip, cheapest, services), page and methodology.'
headers:
RateLimit-Limit:
$ref: '#/components/headers/RateLimit-Limit'
RateLimit-Remaining:
$ref: '#/components/headers/RateLimit-Remaining'
RateLimit-Reset:
$ref: '#/components/headers/RateLimit-Reset'
RateLimit-Policy:
$ref: '#/components/headers/RateLimit-Policy'
content:
application/json:
schema:
$ref: '#/components/schemas/PriceIndexIssue'
example:
month: 2026-10
label: October 2026
captured_on: '2026-10-05'
origin: Newark, NJ (07102)
basket_average: 14.86
carrier_wins:
USPS: 22
UPS: 6
FedEx: 2
cells:
- box: Shoebox
dims: 13 x 9 x 5 in
weight: 3 lb
to: Chicago, IL
to_zip: '60601'
cheapest:
carrier: USPS
service: Ground Advantage
amount: 11.62
delivery_window: 3-5 business days
services:
- carrier: USPS
service: Ground Advantage
amount: 11.62
retail_amount: 14.4
delivery_window: 3-5 business days
- carrier: UPS
service: Ground
amount: 15.94
retail_amount: 21.05
delivery_window: 3 business days
page: https://smklog.com/lp/parcel-price-index-october-2026
methodology: Every price is the complete checkout total (carrier cost plus the SMKlog fee) for the cheapest purchasable services, quoted live through the same pipeline that prices real shipments.
'400':
description: invalid_month — month is not shaped YYYY-MM.
content:
application/json:
schema:
$ref: '#/components/schemas/Problem'
example:
error: invalid_month
message: Pass month as YYYY-MM, e.g. 2026-08.
'404':
description: issue_not_found — no issue is published for that month (available_months lists every one that is); no_issues — nothing is published yet.
content:
application/json:
schema:
$ref: '#/components/schemas/Problem'
example:
error: issue_not_found
message: 'No price-index issue is published for 2026-06. Available: 2026-10, 2026-09, 2026-08, 2026-07.'
available_months:
- 2026-10
- 2026-09
- 2026-08
- 2026-07
'429':
description: rate_limited — 25 reads an hour per client. RateLimit-Reset and Retry-After say how many seconds until the hourly window turns.
content:
application/json:
schema:
$ref: '#/components/schemas/Problem'
example:
error: rate_limited
message: Too many Smart Quote API requests from this client. Try again later.
headers:
RateLimit-Limit:
$ref: '#/components/headers/RateLimit-Limit'
RateLimit-Remaining:
$ref: '#/components/headers/RateLimit-Remaining'
RateLimit-Reset:
$ref: '#/components/headers/RateLimit-Reset'
RateLimit-Policy:
$ref: '#/components/headers/RateLimit-Policy'
Retry-After:
$ref: '#/components/headers/Retry-After'
components:
schemas:
PriceIndexIssue:
type: object
description: 'One monthly issue of the SMKlog parcel shipping price index: six common boxes shipped from Newark, NJ to five US cities, each cell the cheapest purchasable checkout total with every service behind it. The same checkout totals are published on the issue pages and in the open dataset https://smklog.com/downloads/parcel-price-index.csv (CC BY 4.0, DOI 10.5281/zenodo.23376798).'
required:
- month
- label
- captured_on
- origin
- cells
- page
properties:
month:
type: string
pattern: ^[0-9]{4}-[0-9]{2}$
description: The issue, YYYY-MM
label:
type: string
description: The issue name, e.g. October 2026
captured_on:
type: string
description: The date the prices were captured, YYYY-MM-DD
origin:
type: string
description: Where every box ships from
basket_average:
type:
- number
- 'null'
description: Average of the cheapest checkout totals across the basket, USD
carrier_wins:
type:
- object
- 'null'
additionalProperties:
type: integer
description: How many cells each carrier is cheapest in
cells:
type: array
description: One entry per box and destination
items:
type: object
properties:
box:
type: string
description: The basket box
dims:
type: string
description: Its size in inches
weight:
type: string
description: Its weight
to:
type: string
description: Destination city
to_zip:
type: string
description: Destination ZIP
cheapest:
type: object
description: The cheapest purchasable service for this cell
properties:
carrier:
type: string
service:
type: string
amount:
type: number
description: Checkout total, USD, with the SMKlog fee inside
delivery_window:
type:
- string
- 'null'
services:
type: array
description: Every purchasable service quoted for this cell, cheapest first
items:
type: object
properties:
carrier:
type: string
service:
type: string
amount:
type: number
description: Checkout total, USD, with the SMKlog fee inside
retail_amount:
type: number
description: The carrier’s own counter price for the same parcel, 0 where none is published
delivery_window:
type:
- string
- 'null'
page:
type: string
format: uri
description: The published issue page
methodology:
type: string
description: How the prices were captured
Problem:
type: object
description: 'Every error answer on this host: a stable machine-readable code in error, a sentence for the human in message, and the missing field names when the code is missing_required_fields.'
required:
- error
properties:
error:
type: string
description: 'Stable code: invalid_json, invalid_request, missing_required_fields, product_not_recognized, product_url_not_detected, session_failed, session_in_checkout, session_cancelled, session_not_found, idempotency_key_reused, idempotency_key_in_progress, rate_limited, invalid_token, token_required, tracking_number_required, tracking_not_found, invalid_month, issue_not_found, no_issues'
message:
type: string
description: What went wrong, in a sentence
missing:
type: array
items:
type: string
description: Field names still needed, with missing_required_fields and product_not_recognized
session_id:
type: string
description: 'With session_in_checkout, session_cancelled or session_not_found: the session the refusal is about (for session_in_checkout, the one whose checkout the human has started)'
external_id:
type: string
description: 'With session_in_checkout: the external_id you sent'
available_months:
type: array
items:
type: string
description: 'With issue_not_found and no_issues: every published price-index month, newest first'
headers:
Retry-After:
description: 'Seconds to wait before retrying (RFC 9110 section 10.2.3). On 429: until the hourly window turns, equal to RateLimit-Reset, or until 00:00 UTC for daily_session_limit. On 409 idempotency_key_in_progress: until the first call with the same key has its answer; absent on the other 409 answers.'
schema:
type: integer
minimum: 1
example: 1740
RateLimit-Limit:
description: Requests this client may make in the current one-hour window of the bucket the operation draws on (IETF draft-ietf-httpapi-ratelimit-headers).
schema:
type: integer
minimum: 1
example: 80
RateLimit-Remaining:
description: Requests left in the current window after this one; 0 means the next call answers 429 until RateLimit-Reset elapses.
schema:
type: integer
minimum: 0
example: 79
RateLimit-Reset:
description: Seconds until the window turns and the full allowance returns.
schema:
type: integer
minimum: 1
example: 1740
RateLimit-Policy:
description: 'The policy in force as "<limit>;w=<window seconds>": the allowance and the hour it is measured over.'
schema:
type: string
pattern: ^[0-9]+;w=3600$
example: 80;w=3600
securitySchemes:
clientCredentials:
type: oauth2
description: 'Optional on every operation but upsertPaymentSession, which always needs one. A token scopes external_id (the create-or-update on createPaymentSession and upsertPaymentSession) and the Idempotency-Key header on the payment-session writes; a call that sends neither works without a token. Any agent registers an OAuth 2.0 client_credentials client itself, with no human step, at POST https://quote-api.smklog.com/oauth/register (RFC 7591; such a client runs at the public limits), or asks info@smklog.com for a client with its own larger hourly bucket (https://smklog.com/auth.md); either way it sends the opaque bearer it gets from /oauth/token. Discovery: /.well-known/oauth-authorization-server (registration_endpoint).'
flows:
clientCredentials:
tokenUrl: https://quote-api.smklog.com/oauth/token
scopes:
quote: Price parcels and prepare checkouts from a dedicated per-client rate-limit bucket
externalDocs:
description: 'Developer portal: docs, schemas, playground, rate limits, status'
url: https://smklog.com/developers/
x-provenance:
method: published
publisher: SMKlog (SMKLOG-2022 LLC)
source: https://quote-api.smklog.com/openapi.json
published: '2026-11-07'
x-mcp:
transport: streamable-http
endpoint: https://quote-api.smklog.com/mcp
serverCard: https://quote-api.smklog.com/.well-known/mcp/server-card.json