SMKlog Holiday Shipping API

Carrier service calendar: the carriers’ own send-by dates for delivery by the winter holidays (USPS and FedEx; UPS publishes none), marked for today.

GitHub OpenAPI

Operations 1

1 of 1 operations are conformant: apis.io called them with no credentials and the responses matched this contract. Checked 2026-11-12. how this works · status file

GET /holiday-deadlines Read the carriers’ holiday shipping deadlines conformant #

Documentation

Specifications

SDKs

Schemas & Data

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/smklog-com:smklog-com-holiday-shipping-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

smklog-com-holiday-shipping-api-openapi.yml Raw ↑
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