SMKlog Dimensional Weight API

Carrier rating rules: the billable (dimensional) weight of a box under the USPS, UPS and FedEx rules (the 139 divisor), and whether it fits parcel and USPS size limits.

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 /billable-weight Work out the billable (dimensional) weight of a box 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-dimensional-weight-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-dimensional-weight-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: SMKlog Quote Dimensional Weight 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: Dimensional Weight
  description: 'Carrier rating rules: the billable (dimensional) weight of a box under the USPS, UPS and FedEx rules (the 139 divisor), and whether it fits parcel and USPS size limits.'
paths:
  /billable-weight:
    get:
      operationId: calculateBillableWeight
      tags:
      - Dimensional Weight
      x-agentic-access:
        action-class: connected
        consequence: read
        subject: optional
        audience: https://quote-api.smklog.com
        token:
          max-ttl: 3600
        audit: none
      summary: Work out the billable (dimensional) weight of a box
      description: 'The weight USPS, UPS and FedEx bill for one box: the dimensional weight (length x width x height / 139) against the actual weight, rounded the way each carrier rounds, plus whether the box fits parcel limits (150 lb, 108 in on the longest side, 165 in of length plus girth) and the USPS limits (70 lb; 130 in of length plus girth for Ground Advantage, 108 in for Priority Mail). USPS rounds each side up to a whole inch and applies the rule only above 1728 cubic inches (one cubic foot); UPS and FedEx round each side to the nearest inch and apply it to every box. Every weight rounds up to a whole pound; under 1 lb USPS prices by the ounce. When the box bills 2 lb or more above its weight, hint names the largest box that would bill at the real weight. A calculation from the carriers’ published rules: no carrier call, no quote allowance, nothing stored; getParcelQuote prices the box live. The REST twin of the calculate_billable_weight MCP tool; 60 calls an hour per client, shared by the three reference reads and their tools.'
      parameters:
      - name: length_in
        in: query
        required: true
        schema:
          type: number
          exclusiveMinimum: 0
          maximum: 1000
        description: Packed box length in inches (centimeters / 2.54)
        example: 14
      - name: width_in
        in: query
        required: true
        schema:
          type: number
          exclusiveMinimum: 0
          maximum: 1000
        description: Packed box width in inches
        example: 10
      - name: height_in
        in: query
        required: true
        schema:
          type: number
          exclusiveMinimum: 0
          maximum: 1000
        description: Packed box height in inches
        example: 6
      - name: weight_lb
        in: query
        required: true
        schema:
          type: number
          exclusiveMinimum: 0
          maximum: 1000
        description: Packed weight in pounds (kilograms x 2.2046)
        example: 4
      responses:
        '200':
          description: box_in, actual_weight_lb, rounded_weight_lb, length_plus_girth_in, carriers (USPS, UPS, FedEx), limits, hint 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/BillableWeight'
              example:
                box_in:
                - 14
                - 10
                - 6
                actual_weight_lb: 4
                rounded_weight_lb: 4
                length_plus_girth_in: 46
                carriers:
                - carrier: USPS
                  side_rounding: up
                  cubic_inches: 840
                  dimensional_weight_lb: null
                  billable_weight_lb: 4
                  billed_by_size: false
                  rule: Length x width x height / 139, each side rounded up to a whole inch, only for a box over 1728 cubic inches (one cubic foot); under it USPS bills the actual weight.
                - carrier: UPS
                  side_rounding: nearest
                  cubic_inches: 840
                  dimensional_weight_lb: 7
                  billable_weight_lb: 7
                  billed_by_size: true
                  rule: Length x width x height / 139, each side rounded to the nearest whole inch, on every package (daily rates).
                - carrier: FedEx
                  side_rounding: nearest
                  cubic_inches: 840
                  dimensional_weight_lb: 7
                  billable_weight_lb: 7
                  billed_by_size: true
                  rule: Length x width x height / 139, each side rounded to the nearest whole inch, on every package.
                limits:
                  within_parcel_limits: true
                  parcel_rule: Up to 150 lb, 108 in on the longest side and 165 in of length plus girth; a bigger box is not a parcel and get_parcel_quote answers not_a_parcel.
                  usps_ground_advantage: true
                  usps_priority_mail: true
                hint: 'Billed by size: this 14 x 10 x 6 in box counts as 7 lb, while the packed item weighs about 4 lb. A box up to 556 cubic inches (for example 12 x 8 x 5 in) is billed at the real weight, and USPS bills any box up to 1728 cubic inches by weight.'
                note: How the carriers bill a box this size, worked out from their published rules. The carrier’s own measurement at acceptance decides, and a box that measures larger is billed as a carrier adjustment. get_parcel_quote prices it live.
        '400':
          description: missing_required_fields — one of the four values is absent (missing names it); invalid_request — a value is not a number above 0 and at most 1000.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
              example:
                error: missing_required_fields
                message: 'Send length_in, width_in, height_in and weight_lb: the packed box in inches and its weight in pounds.'
                missing:
                - weight_lb
        '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:
    BillableWeight:
      type: object
      description: How USPS, UPS and FedEx bill one box, and the limits it meets.
      required:
      - box_in
      - actual_weight_lb
      - rounded_weight_lb
      - length_plus_girth_in
      - carriers
      - limits
      - hint
      - note
      properties:
        box_in:
          type: array
          items:
            type: integer
          minItems: 3
          maxItems: 3
          description: Sides rounded up to whole inches, longest first
        actual_weight_lb:
          type: number
          description: Packed weight sent, pounds
        rounded_weight_lb:
          type: integer
          description: Packed weight rounded up to a whole pound, at least 1
        length_plus_girth_in:
          type: integer
          description: Longest side plus twice the other two, sides rounded up
        carriers:
          type: array
          description: USPS, UPS and FedEx, in that order
          items:
            type: object
            required:
            - carrier
            - side_rounding
            - cubic_inches
            - dimensional_weight_lb
            - billable_weight_lb
            - billed_by_size
            - rule
            properties:
              carrier:
                type: string
                enum:
                - USPS
                - UPS
                - FedEx
              side_rounding:
                type: string
                enum:
                - up
                - nearest
                description: Per-side rounding before multiplying
              cubic_inches:
                type: integer
                description: L x W x H after that rounding
              dimensional_weight_lb:
                type:
                - integer
                - 'null'
                description: Cubic inches / 139, rounded up; null when USPS bills by weight alone (1728 cubic inches or less)
              billable_weight_lb:
                type: integer
                description: The larger of the rounded actual and dimensional weights
              billed_by_size:
                type: boolean
                description: True when the dimensional weight is larger
              rule:
                type: string
                description: The rule applied, in a sentence
              note:
                type: string
                description: 'USPS under 1 lb: priced by the ounce'
        limits:
          type: object
          required:
          - within_parcel_limits
          - parcel_rule
          - usps_ground_advantage
          - usps_priority_mail
          properties:
            within_parcel_limits:
              type: boolean
              description: Fits the parcel limits in parcel_rule
            parcel_rule:
              type: string
              description: The parcel limits in a sentence
            usps_ground_advantage:
              type: boolean
              description: At most 70 lb and 130 in of length plus girth
            usps_priority_mail:
              type: boolean
              description: At most 70 lb and 108 in of length plus girth
        hint:
          type:
          - string
          - 'null'
          description: Box-size advice when the box bills 2 lb or more above its weight; else null
        note:
          type: string
          description: 'What decides: the carrier’s own measurement at 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'
  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