SMKlog Shipping Restrictions API

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.

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 /shipping-restrictions Read what SMKlog will not ship and the lithium battery rules 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-shipping-restrictions-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-shipping-restrictions-api-openapi.yml Raw ↑
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