Comet Messenger Service Book API
The Book API from Comet Messenger Service — 1 operation(s) for book.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/cometmessenger-delivery:cometmessenger-delivery-book-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
openapi: 3.2.0
info:
title: Cometmessenger Delivery Book API
version: 2.0.1
contact:
name: Comet Messenger Service
url: https://cometmessenger.delivery
description: 'Operations tagged Book across 2 of this provider''s published API definitions: cometmessenger-delivery-openapi.json, cometmessenger-delivery-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://agents.cometmessenger.delivery
tags:
- name: Book
paths:
/book:
post:
operationId: book_delivery
summary: Book a Comet delivery (account holders)
description: 'Book a same-day courier delivery on a Comet account. Call first without confirm to get a preview (price, vehicle, pickup time); show it to your user; then call again with the same details and confirm=true to place the order. Returns the Comet order number. Needs the client''s Comet account key (Authorization: Bearer cmt_...). Account holders get one from Comet at (312) 786-2288.'
security:
- accountKey: []
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
service:
type: string
enum:
- streak
- priority
- standard
description: Streak (fastest, about 1-2 h), Priority (about 2-3 h) or Standard (about 4-6 h). Only the services on the account are accepted.
pickup_name:
type: string
description: Company or person at pickup. Omit pickup fields entirely to pick up at the account's own office.
pickup_street:
type: string
description: Pickup street address, e.g. '300 N LaSalle St'
pickup_city:
type: string
description: City (default Chicago)
pickup_state:
type: string
description: Two-letter state (default IL)
pickup_zip:
type: string
description: ZIP code
pickup_suite:
type: string
description: Suite / floor at pickup
pickup_contact:
type: string
pickup_phone:
type: string
pickup_notes:
type: string
description: Instructions for the courier at pickup
dropoff_name:
type: string
description: Company or person receiving the delivery
dropoff_street:
type: string
description: Drop-off street address, e.g. '300 N LaSalle St'
dropoff_city:
type: string
description: City (default Chicago)
dropoff_state:
type: string
description: Two-letter state (default IL)
dropoff_zip:
type: string
description: ZIP code
dropoff_suite:
type: string
description: Suite / floor at drop-off
dropoff_contact:
type: string
dropoff_phone:
type: string
dropoff_notes:
type: string
description: Instructions for the courier at drop-off
pieces:
type: integer
minimum: 1
description: Number of pieces (default 1)
weight_lb:
type: number
minimum: 0
description: Total weight in pounds. Picks the vehicle when none is given.
vehicle:
type: string
enum:
- auto
- bike
- car
- suv
- minivan
- cargovan
- sprintervan
- truck
description: Vehicle wanted; 'auto' (default) picks from the weight. A heavier load is moved up to the vehicle it needs.
round_trip:
type: boolean
description: True when the courier returns to the pickup (default false)
package_type:
type: string
enum:
- envelope
- box
- other
description: Default envelope
when:
type: string
description: '''now'' (default) or a pickup time in Chicago time today or tomorrow, e.g. ''2026-10-13T09:00''. Further ahead: call the office.'
reference:
type: string
description: Client reference / matter number for the invoice
reference2:
type: string
ordered_by:
type: string
description: Name of the person the agent is acting for
notify_email:
type: string
description: Email for the order confirmation and delivery notice
confirm:
type: boolean
description: false/omitted = preview only (price and details, nothing booked). true = place the order. Always show the preview to your user before confirming.
required:
- service
- dropoff_name
- dropoff_street
- dropoff_zip
responses:
'200':
description: Result; ok=false carries an error code, a message and Comet's phone number
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
placed:
type: boolean
description: True only when a real order was created
preview:
type: boolean
order_number:
type: string
description: Comet / Xcelerator tracking number once entered, e.g. '516.101226'
request_id:
type: string
status:
type: string
account:
type: string
service:
type: string
vehicle:
type: string
pickup:
type: string
dropoff:
type: string
pickup_time:
type: string
estimated_price:
type: string
description: List-rate estimate; the account's own rate applies on the invoice
message:
type: string
error:
type: string
required:
- ok
tags:
- Book
servers:
- url: https://agents.cometmessenger.delivery
components:
securitySchemes:
accountKey:
type: http
scheme: bearer
description: Comet account key (cmt_...). Issued by Comet to account holders.
x-refined-from:
- cometmessenger-delivery-openapi.json
- cometmessenger-delivery-openapi.yml