Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: SMKlog Quote Dimensional Weight 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: Dimensional Weight
description: 'Carrier rating rules: the billable (dimensional) weight of a box under the USPS, UPS and FedEx rules (the 139 divisor), and whether it fits parcel and USPS size limits.'
paths:
/billable-weight:
get:
operationId: calculateBillableWeight
tags:
- Dimensional Weight
x-agentic-access:
action-class: connected
consequence: read
subject: optional
audience: https://quote-api.smklog.com
token:
max-ttl: 3600
audit: none
summary: Work out the billable (dimensional) weight of a box
description: 'The weight USPS, UPS and FedEx bill for one box: the dimensional weight (length x width x height / 139) against the actual weight, rounded the way each carrier rounds, plus whether the box fits parcel limits (150 lb, 108 in on the longest side, 165 in of length plus girth) and the USPS limits (70 lb; 130 in of length plus girth for Ground Advantage, 108 in for Priority Mail). USPS rounds each side up to a whole inch and applies the rule only above 1728 cubic inches (one cubic foot); UPS and FedEx round each side to the nearest inch and apply it to every box. Every weight rounds up to a whole pound; under 1 lb USPS prices by the ounce. When the box bills 2 lb or more above its weight, hint names the largest box that would bill at the real weight. A calculation from the carriers’ published rules: no carrier call, no quote allowance, nothing stored; getParcelQuote prices the box live. The REST twin of the calculate_billable_weight MCP tool; 60 calls an hour per client, shared by the three reference reads and their tools.'
parameters:
- name: length_in
in: query
required: true
schema:
type: number
exclusiveMinimum: 0
maximum: 1000
description: Packed box length in inches (centimeters / 2.54)
example: 14
- name: width_in
in: query
required: true
schema:
type: number
exclusiveMinimum: 0
maximum: 1000
description: Packed box width in inches
example: 10
- name: height_in
in: query
required: true
schema:
type: number
exclusiveMinimum: 0
maximum: 1000
description: Packed box height in inches
example: 6
- name: weight_lb
in: query
required: true
schema:
type: number
exclusiveMinimum: 0
maximum: 1000
description: Packed weight in pounds (kilograms x 2.2046)
example: 4
responses:
'200':
description: box_in, actual_weight_lb, rounded_weight_lb, length_plus_girth_in, carriers (USPS, UPS, FedEx), limits, hint and note.
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/BillableWeight'
example:
box_in:
- 14
- 10
- 6
actual_weight_lb: 4
rounded_weight_lb: 4
length_plus_girth_in: 46
carriers:
- carrier: USPS
side_rounding: up
cubic_inches: 840
dimensional_weight_lb: null
billable_weight_lb: 4
billed_by_size: false
rule: Length x width x height / 139, each side rounded up to a whole inch, only for a box over 1728 cubic inches (one cubic foot); under it USPS bills the actual weight.
- carrier: UPS
side_rounding: nearest
cubic_inches: 840
dimensional_weight_lb: 7
billable_weight_lb: 7
billed_by_size: true
rule: Length x width x height / 139, each side rounded to the nearest whole inch, on every package (daily rates).
- carrier: FedEx
side_rounding: nearest
cubic_inches: 840
dimensional_weight_lb: 7
billable_weight_lb: 7
billed_by_size: true
rule: Length x width x height / 139, each side rounded to the nearest whole inch, on every package.
limits:
within_parcel_limits: true
parcel_rule: Up to 150 lb, 108 in on the longest side and 165 in of length plus girth; a bigger box is not a parcel and get_parcel_quote answers not_a_parcel.
usps_ground_advantage: true
usps_priority_mail: true
hint: 'Billed by size: this 14 x 10 x 6 in box counts as 7 lb, while the packed item weighs about 4 lb. A box up to 556 cubic inches (for example 12 x 8 x 5 in) is billed at the real weight, and USPS bills any box up to 1728 cubic inches by weight.'
note: How the carriers bill a box this size, worked out from their published rules. The carrier’s own measurement at acceptance decides, and a box that measures larger is billed as a carrier adjustment. get_parcel_quote prices it live.
'400':
description: missing_required_fields — one of the four values is absent (missing names it); invalid_request — a value is not a number above 0 and at most 1000.
content:
application/json:
schema:
$ref: '#/components/schemas/Problem'
example:
error: missing_required_fields
message: 'Send length_in, width_in, height_in and weight_lb: the packed box in inches and its weight in pounds.'
missing:
- weight_lb
'429':
description: rate_limited — 60 calls an hour per client, shared by calculateBillableWeight, getHolidayShippingDeadlines, getShippingRestrictions and their MCP tools. 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:
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
schemas:
BillableWeight:
type: object
description: How USPS, UPS and FedEx bill one box, and the limits it meets.
required:
- box_in
- actual_weight_lb
- rounded_weight_lb
- length_plus_girth_in
- carriers
- limits
- hint
- note
properties:
box_in:
type: array
items:
type: integer
minItems: 3
maxItems: 3
description: Sides rounded up to whole inches, longest first
actual_weight_lb:
type: number
description: Packed weight sent, pounds
rounded_weight_lb:
type: integer
description: Packed weight rounded up to a whole pound, at least 1
length_plus_girth_in:
type: integer
description: Longest side plus twice the other two, sides rounded up
carriers:
type: array
description: USPS, UPS and FedEx, in that order
items:
type: object
required:
- carrier
- side_rounding
- cubic_inches
- dimensional_weight_lb
- billable_weight_lb
- billed_by_size
- rule
properties:
carrier:
type: string
enum:
- USPS
- UPS
- FedEx
side_rounding:
type: string
enum:
- up
- nearest
description: Per-side rounding before multiplying
cubic_inches:
type: integer
description: L x W x H after that rounding
dimensional_weight_lb:
type:
- integer
- 'null'
description: Cubic inches / 139, rounded up; null when USPS bills by weight alone (1728 cubic inches or less)
billable_weight_lb:
type: integer
description: The larger of the rounded actual and dimensional weights
billed_by_size:
type: boolean
description: True when the dimensional weight is larger
rule:
type: string
description: The rule applied, in a sentence
note:
type: string
description: 'USPS under 1 lb: priced by the ounce'
limits:
type: object
required:
- within_parcel_limits
- parcel_rule
- usps_ground_advantage
- usps_priority_mail
properties:
within_parcel_limits:
type: boolean
description: Fits the parcel limits in parcel_rule
parcel_rule:
type: string
description: The parcel limits in a sentence
usps_ground_advantage:
type: boolean
description: At most 70 lb and 130 in of length plus girth
usps_priority_mail:
type: boolean
description: At most 70 lb and 108 in of length plus girth
hint:
type:
- string
- 'null'
description: Box-size advice when the box bills 2 lb or more above its weight; else null
note:
type: string
description: 'What decides: the carrier’s own measurement at acceptance'
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'
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