Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: SMKlog Quote Shipping Restrictions 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: Shipping Restrictions
description: 'Dangerous goods and prohibited items acceptance rules: what SMKlog will not ship, what ships only with conditions (ground only, lithium battery marks), and the lithium battery rules the checkout applies before a label is sold.'
paths:
/shipping-restrictions:
get:
operationId: getShippingRestrictions
tags:
- Shipping Restrictions
x-agentic-access:
action-class: connected
consequence: read
subject: optional
audience: https://quote-api.smklog.com
token:
max-ttl: 3600
audit: none
summary: Read what SMKlog will not ship and the lithium battery rules
description: 'SMKlog’s shipping restrictions as published at https://smklog.com/shipping-restrictions: the prohibited categories (weapons, drugs, counterfeit goods, money and valuables, living and perishable contents, dangerous goods, controlled exports), the restricted ones that ship only with conditions (batteries and electronics, medicine, chemicals and aerosols, regulated natural products, age-restricted goods), the lithium battery rules the checkout applies (installed: UN3481 mark, domestic ground; power banks: UN3480, domestic ground only, up to 100 Wh and 5 lb; larger or lithium-metal batteries reviewed by hand; damaged ones refused), how to describe an item, and the international rules. A policy reference, not a verdict on one item: getParcelQuote and the checkout check each item, by name as well as by keyword. The REST twin of the get_shipping_restrictions MCP tool; no carrier call, no quote allowance, 60 calls an hour per client, shared by the three reference reads and their tools.'
responses:
'200':
description: policy_page, summary, prohibited, restricted, restricted_handling, batteries, descriptions, international, how_smklog_checks and carrier_rules_control.
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/ShippingRestrictions'
example:
policy_page: https://smklog.com/shipping-restrictions
summary: SMKlog sells parcel labels only for shipments that are lawful, eligible for the chosen carrier service, accurately declared, correctly packed and acceptable at the destination. The lists are examples, not a complete list; carrier, airline, export, customs and destination rules can be stricter and change at any time.
prohibited:
- category: Weapons
examples: Firearms, guns, firearm parts, firearm accessories, ammunition, gunpowder, magazines, clips, scopes, lasers, sights, night vision, barrels, silencers, body armor
- category: Drugs and unidentified substances
examples: Marijuana, THC, synthetic cannabis, kratom, hemp products, controlled substances, illicit substances, narcotics, psychotropic drugs, unidentified powders, liquids, pills, capsules
- category: Counterfeit and unauthorized goods
examples: Counterfeit, replica, bootleg, illegal, stolen, trademark-infringing, copyright-infringing, otherwise unauthorized goods
- category: Money and valuables
examples: Cash, coins, banknotes, bearer instruments, money orders, negotiable instruments, gift cards, lottery tickets, event tickets, gambling materials, slot machines, bullion, gold, silver, platinum, loose diamonds, gems, precious stones
- category: Living, biological and perishable
examples: Live animals, human remains, live bait, frozen food, dry ice, perishable goods, biological cultures, medical samples, specimens, infectious materials, temperature-controlled contents
- category: Dangerous goods
examples: Explosives, fireworks, lighters, fire extinguishers, pepper spray, mace, tear gas, poisons, toxic substances, oxidizers, radioactive materials, air bags, pretensioners, other dangerous goods
- category: Controlled exports
examples: Items requiring an export license, ITAR control, EAR control, military authorization, sanctions review, customs permit, import permit, shipment to a prohibited person, party, country, or destination
restricted:
- category: Batteries and electronics
examples: Lithium ion batteries, lithium metal batteries, power banks, loose batteries, replacement batteries, lead-acid batteries, used electronics, damaged electronics, recalled devices, defective devices
- category: Medicine and health products
examples: Prescription medicine, over-the-counter medicine, supplements, vitamins, medical products, health products, products that are not properly labeled for the destination
- category: Chemicals, liquids and aerosols
examples: Fertilizer, paint, varnish, stains, paint thinner, acetone, nail polish, nail polish remover, perfume, cologne, fragrance, aerosols, sprays, glue, adhesives, household chemicals, cleaners, antifreeze, sanitizer, magnets
- category: Regulated natural products
examples: Tobacco, vaping products, nicotine, alcohol, CBD, hemp, coffee, food items, agricultural items, plants, seeds, soil, animal material, animal skins, fur, feathers, insects, shells, coral, marine life
- category: Age-restricted goods
examples: Adult material, sex toys, age-restricted goods, goods that may require adult signature, special handling, destination legality review, additional carrier restrictions
restricted_handling: Restricted items may need special packaging, markings, ground-only service, permits, documentation, an adult signature, carrier approval or a different logistics provider, and the SMKlog online checkout may refuse them even when a carrier might handle them under a separate program.
batteries:
- case: Device with an installed lithium-ion battery (phone, laptop, tablet, camera)
rule: Ships on domestic US ground services with the UN3481 lithium battery mark; the checkout shows the marking step.
- case: Standalone lithium-ion battery or power bank
rule: Domestic US ground only, the whole package at or under 5 lb, the battery at or under 100 Wh, terminals protected, with the UN3480 lithium battery mark and the Surface Mail Only text.
- case: A battery above 100 Wh, installed or not (e-bike, scooter, power station)
rule: 'Fully regulated Class 9: no instant label; SMKlog reviews the shipment by hand.'
- case: Lithium-metal (non-rechargeable) batteries
rule: Need UN3090/UN3091 handling the self-service label does not cover; reviewed by hand.
- case: Damaged, defective, recalled, leaking or swollen batteries and devices
rule: Not accepted.
descriptions: 'Use the real item name: never a generic description such as accessories, parts, tools, gift, merchandise, sample or household item for a phone, battery, liquid, aerosol, supplement, weapon accessory or other regulated product. Declared contents that do not match the product can block checkout or stop the label.'
international: Self-service labels go to Canada, the UK, Germany and Australia; the customs declaration is completed before payment and the shipper is the exporter of record. Other destinations get a manual quote.
how_smklog_checks: SMKlog screens the item description when it prices a shipment and checks the item again before payment, by name as well as by keyword. A prohibited item is refused; a regulated one gets ground services only and a marking step at checkout.
carrier_rules_control: The carrier, airline, government agencies and the destination decide acceptance; a quote or a label does not guarantee that a restricted, misdeclared or wrongly packed parcel is carried or delivered.
'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:
schemas:
ShippingRestrictions:
type: object
description: What SMKlog will not ship and what ships only with conditions, as published at https://smklog.com/shipping-restrictions, with the lithium battery rules the checkout applies.
required:
- policy_page
- summary
- prohibited
- restricted
- restricted_handling
- batteries
- descriptions
- international
- how_smklog_checks
- carrier_rules_control
properties:
policy_page:
type: string
format: uri
description: The published policy
summary:
type: string
prohibited:
type: array
description: Categories refused outright, with examples
items:
type: object
required:
- category
- examples
properties:
category:
type: string
examples:
type: string
restricted:
type: array
description: Categories that ship only with conditions, or that the online checkout may refuse
items:
type: object
required:
- category
- examples
properties:
category:
type: string
examples:
type: string
restricted_handling:
type: string
description: What a restricted item may need
batteries:
type: array
description: The lithium battery rules, case by case
items:
type: object
required:
- case
- rule
properties:
case:
type: string
rule:
type: string
descriptions:
type: string
description: How to describe an item
international:
type: string
description: Destinations and the customs declaration
how_smklog_checks:
type: string
description: When SMKlog checks an item
carrier_rules_control:
type: string
description: Who decides 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'
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