Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: SMKlog Quote Holiday Shipping 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: Holiday Shipping
description: 'Carrier service calendar: the carriers’ own send-by dates for delivery by the winter holidays (USPS and FedEx; UPS publishes none), marked for today.'
paths:
/holiday-deadlines:
get:
operationId: getHolidayShippingDeadlines
tags:
- Holiday Shipping
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 carriers’ holiday shipping deadlines
description: 'The carriers’ own recommended send-by dates for delivery by the 2026 winter holidays, contiguous US to contiguous US: USPS Ground Advantage, Priority Mail and Priority Mail Express for delivery by Dec 25, and FedEx Ground Economy, Ground and Home Delivery (by days in transit, 1 to 5), Express Saver, 2Day and the Overnight services for delivery by Dec 24. Each date is marked on_track or too_late for today in New York, with the page it was read from. UPS publishes no fixed dates (the last day depends on the service and the lane), and the answer says so. After Dec 24, 2026 season_over is true and no dates are listed. Never a guarantee and never an SMKlog estimate; for a real lane getParcelQuote returns each service’s delivery estimate. The REST twin of the get_holiday_shipping_deadlines 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: season, today, season_over, coverage, carriers (USPS, FedEx, UPS with services, dates and statuses) 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/HolidayDeadlines'
example:
season: 2026 winter holidays
today: '2026-12-16'
season_over: false
coverage: Contiguous US to contiguous US. Alaska, Hawaii, Puerto Rico, the territories and military addresses have earlier dates of their own.
carriers:
- carrier: USPS
deliver_by: '2026-12-25'
source: usps.com/holiday/holiday-shipping-dates.htm, read Oct 19, 2026
services:
- service: USPS Ground Advantage
ship_by: '2026-12-17'
status: on_track
- service: Priority Mail
ship_by: '2026-12-18'
status: on_track
- service: Priority Mail Express
ship_by: '2026-12-19'
status: on_track
- carrier: FedEx
deliver_by: '2026-12-24'
source: FedEx 2026 shipping deadlines for holiday packages, linked from fedex.com/en-us/holiday/last-days-to-ship.html, read Oct 21, 2026
services:
- service: FedEx Ground Economy
ship_by: '2026-12-15'
status: too_late
- service: FedEx Ground and Home Delivery
ship_by_by_transit_days:
'1': '2026-12-23'
'2': '2026-12-22'
'3': '2026-12-21'
'4': '2026-12-18'
'5': '2026-12-17'
status_by_transit_days:
'1': on_track
'2': on_track
'3': on_track
'4': on_track
'5': on_track
- service: FedEx Express Saver
ship_by: '2026-12-21'
status: on_track
- service: FedEx 2Day and 2Day A.M.
ship_by: '2026-12-22'
status: on_track
- service: FedEx First, Priority and Standard Overnight
ship_by: '2026-12-23'
status: on_track
- carrier: UPS
deliver_by: null
source: ups.com holiday shipping page, read Oct 21, 2026
note: 'UPS publishes no fixed send-by dates: its holiday page says the last day depends on the UPS service, where the shipment starts and where it is going.'
services: []
note: The carriers’ own recommended send-by dates for delivery by the holiday, not guarantees and not SMKlog estimates. Sending on or before a date is on_track. get_parcel_quote returns each service’s delivery estimate for a real lane.
'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:
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'
HolidayDeadlines:
type: object
description: The carriers’ own recommended send-by dates for delivery by the 2026 winter holidays, each marked on_track or too_late for today in New York.
required:
- season
- today
- season_over
- coverage
- carriers
- note
properties:
season:
type: string
description: Which season the dates are for
today:
type: string
format: date
description: Today in New York (America/New_York), YYYY-MM-DD
season_over:
type: boolean
description: True after Dec 24, 2026; carriers is then empty
coverage:
type: string
description: Which lanes the dates are for
carriers:
type: array
description: USPS, FedEx and UPS
items:
type: object
required:
- carrier
- deliver_by
- source
- services
properties:
carrier:
type: string
enum:
- USPS
- FedEx
- UPS
deliver_by:
type:
- string
- 'null'
format: date
description: 'The day the dates aim at: Dec 25 for USPS, Dec 24 for FedEx; null for UPS'
source:
type: string
description: Where and when SMKlog read the dates
note:
type: string
description: Why a carrier lists no dates
services:
type: array
items:
type: object
required:
- service
properties:
service:
type: string
ship_by:
type: string
format: date
description: Send on or before this date
status:
type: string
enum:
- on_track
- too_late
description: on_track while today is on or before ship_by
ship_by_by_transit_days:
type: object
additionalProperties:
type: string
format: date
description: 'FedEx Ground and Home Delivery: the date by the service’s days in transit on the lane, 1 to 5'
status_by_transit_days:
type: object
additionalProperties:
type: string
enum:
- on_track
- too_late
description: The status of each of those dates
note:
type: string
description: What the dates are and are not
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