SMKlog Price Index API

Parcel price benchmark data: the monthly SMKlog parcel shipping price index, what six common boxes cost to ship from Newark, NJ to five US cities with every service quoted, published as open data (CC BY 4.0).

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 /price-index Read the monthly US parcel shipping price index 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-price-index-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-price-index-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: SMKlog Quote Price Index 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: Price Index
  description: 'Parcel price benchmark data: the monthly SMKlog parcel shipping price index, what six common boxes cost to ship from Newark, NJ to five US cities with every service quoted, published as open data (CC BY 4.0).'
paths:
  /price-index:
    get:
      operationId: getPriceIndex
      tags:
      - Price Index
      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 monthly US parcel shipping price index
      description: 'The SMKlog parcel shipping price index: a basket of six common boxes (1 to 20 lb) shipped from Newark, NJ to five US cities, repriced every month through the same live USPS, UPS and FedEx pipeline that prices real shipments. Each cell is the cheapest purchasable checkout total with every service behind it, and each price is a checkout total with the SMKlog fee inside. Published as open data: the same checkout totals are on the issue pages and in the CC BY 4.0 dataset. Reference data for questions like "what does shipping a shoebox cost in the US right now"; for one specific shipment call getParcelQuote. month picks an issue (YYYY-MM, from 2026-07 on) and its absence returns the newest; a month with no issue answers 404 issue_not_found with available_months, so one miss lists every valid value. The REST twin of the get_price_index MCP tool: a read of published data, no carrier call and no quote allowance, 25 reads an hour per client.'
      parameters:
      - name: month
        in: query
        required: false
        schema:
          type: string
          pattern: ^[0-9]{4}-[0-9]{2}$
        description: Issue month as YYYY-MM. Omit for the newest published issue.
        example: 2026-10
      responses:
        '200':
          description: 'The issue: month, label, captured_on, origin, basket_average, carrier_wins, cells (box, dims, weight, to, to_zip, cheapest, services), page and methodology.'
          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/PriceIndexIssue'
              example:
                month: 2026-10
                label: October 2026
                captured_on: '2026-10-05'
                origin: Newark, NJ (07102)
                basket_average: 14.86
                carrier_wins:
                  USPS: 22
                  UPS: 6
                  FedEx: 2
                cells:
                - box: Shoebox
                  dims: 13 x 9 x 5 in
                  weight: 3 lb
                  to: Chicago, IL
                  to_zip: '60601'
                  cheapest:
                    carrier: USPS
                    service: Ground Advantage
                    amount: 11.62
                    delivery_window: 3-5 business days
                  services:
                  - carrier: USPS
                    service: Ground Advantage
                    amount: 11.62
                    retail_amount: 14.4
                    delivery_window: 3-5 business days
                  - carrier: UPS
                    service: Ground
                    amount: 15.94
                    retail_amount: 21.05
                    delivery_window: 3 business days
                page: https://smklog.com/lp/parcel-price-index-october-2026
                methodology: Every price is the complete checkout total (carrier cost plus the SMKlog fee) for the cheapest purchasable services, quoted live through the same pipeline that prices real shipments.
        '400':
          description: invalid_month — month is not shaped YYYY-MM.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
              example:
                error: invalid_month
                message: Pass month as YYYY-MM, e.g. 2026-08.
        '404':
          description: issue_not_found — no issue is published for that month (available_months lists every one that is); no_issues — nothing is published yet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
              example:
                error: issue_not_found
                message: 'No price-index issue is published for 2026-06. Available: 2026-10, 2026-09, 2026-08, 2026-07.'
                available_months:
                - 2026-10
                - 2026-09
                - 2026-08
                - 2026-07
        '429':
          description: rate_limited — 25 reads an hour per client. 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:
    PriceIndexIssue:
      type: object
      description: 'One monthly issue of the SMKlog parcel shipping price index: six common boxes shipped from Newark, NJ to five US cities, each cell the cheapest purchasable checkout total with every service behind it. The same checkout totals are published on the issue pages and in the open dataset https://smklog.com/downloads/parcel-price-index.csv (CC BY 4.0, DOI 10.5281/zenodo.23376798).'
      required:
      - month
      - label
      - captured_on
      - origin
      - cells
      - page
      properties:
        month:
          type: string
          pattern: ^[0-9]{4}-[0-9]{2}$
          description: The issue, YYYY-MM
        label:
          type: string
          description: The issue name, e.g. October 2026
        captured_on:
          type: string
          description: The date the prices were captured, YYYY-MM-DD
        origin:
          type: string
          description: Where every box ships from
        basket_average:
          type:
          - number
          - 'null'
          description: Average of the cheapest checkout totals across the basket, USD
        carrier_wins:
          type:
          - object
          - 'null'
          additionalProperties:
            type: integer
          description: How many cells each carrier is cheapest in
        cells:
          type: array
          description: One entry per box and destination
          items:
            type: object
            properties:
              box:
                type: string
                description: The basket box
              dims:
                type: string
                description: Its size in inches
              weight:
                type: string
                description: Its weight
              to:
                type: string
                description: Destination city
              to_zip:
                type: string
                description: Destination ZIP
              cheapest:
                type: object
                description: The cheapest purchasable service for this cell
                properties:
                  carrier:
                    type: string
                  service:
                    type: string
                  amount:
                    type: number
                    description: Checkout total, USD, with the SMKlog fee inside
                  delivery_window:
                    type:
                    - string
                    - 'null'
              services:
                type: array
                description: Every purchasable service quoted for this cell, cheapest first
                items:
                  type: object
                  properties:
                    carrier:
                      type: string
                    service:
                      type: string
                    amount:
                      type: number
                      description: Checkout total, USD, with the SMKlog fee inside
                    retail_amount:
                      type: number
                      description: The carrier’s own counter price for the same parcel, 0 where none is published
                    delivery_window:
                      type:
                      - string
                      - 'null'
        page:
          type: string
          format: uri
          description: The published issue page
        methodology:
          type: string
          description: How the prices were captured
    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