buy_shipment
ChatGPTBuy one rate on one shipment. This debits the postage wallet and returns the label and tracking code. It does not show whether a payment method refilled the wallet. The user should approve the carrier, service, and price first. expected_rate is that price and has to match the rate being bought. Insurance on this call covers the package at purchase. Leaving insurance off is not a decline: a default insurance amount may cover a qualifying shipment, and passing 0 declines coverage. The response shows the coverage that was applied. A shipment already bought with this rate is returned as-is when insurance is omitted or matches the coverage already on it. Passing 0 matches no coverage. A different amount is refused. insure_shipment adds coverage after purchase only when the shipment has none. A rate from an earlier turn needs a new shipment. If this buy times out, the connection drops, or the buy conflicts or returns a server error, call buy_shipment again with the same shipment_id and rate_id.
carrier_metadata
ChatGPTLook up what EasyPost carriers support: service levels, predefined package types, shipment options, and supported features. Omit carriers to list every carrier by name, or pass carriers='usps,fedex' for the full metadata of those carriers. Narrow the answer with types, any of service_levels, predefined_packages, shipment_options, supported_features. This is the catalog of what carriers can do, not the accounts this user has connected; use list_carrier_accounts for those.
claims
ChatGPTCheck the status of insurance claims filed for lost, damaged, or stolen shipments. Pass claim_id (clm_) to show one claim with its full status history, which ignores every filter below. Otherwise this lists claims, filtered by status (submitted, in_review, needs_action, approved, approved_partial, rejected, cancelled) and claim_type (damage, loss, theft). Listing covers the last month unless you pass a date window, so pass start_datetime to look further back, and never read an empty list as proof the user has no claims. Use insurances for the policy a claim was filed against. This only reads; it never files or cancels a claim.
create_and_verify_address
ChatGPTVerify one address for deliverability and store it. Returns an adr_ id, verifications.delivery.success, and any delivery error messages. A failed check still returns the address with success false. Each call is billed. This checks an address before there is a parcel. create_shipment verifies the address it will deliver to, so once a parcel is known that address belongs there. Verifying and then rating the same address bills verification twice.
create_refund
ChatGPTRequest a refund for one unused purchased label, by its tracking code. One code per call. A label the carrier has already taken may be refused. Status is read with the refunds tool, which never files a refund.
create_shipment
ChatGPTQuote rates for one domestic US shipment. This does not buy a label. Origin, destination, and parcel are inline. country is required and must be US. parcel.weight is ounces. There is no address book and no rerate tool. Rating can be metered on a rating subscription. The destination is verified for deliverability on this call, and that check is billed. The result is to_address.verifications.delivery.success, or from_address.verifications.delivery.success when is_return is set. Do not also call create_and_verify_address for that destination. Keep the merchant in from_address and the customer in to_address, the same as the outbound label. is_return delivers to the merchant. Do not swap the addresses. It applies when the user asked for a return. Rate ids on this response are the ones a buy can use. A rate from an earlier turn needs a new shipment. messages explains an empty rate list.
create_tracker
ChatGPTRegister one tracking number that was not bought through EasyPost. The first registration is billed. A repeat of a number that already has a tracker returns that tracker without another charge. One tracking code per call.
get_address
ChatGPTShow one stored address by address_id (adr_), for example an id taken from a shipment. This does not verify or create addresses.
get_shipment
ChatGPTShow one shipment with its label URLs, stored rates, and tracker summary. Pass exactly one of shipment_id (shp_) or tracking_code, preferring shipment_id.
get_tracker
ChatGPTShow where a package is. Pass exactly one of tracker_id (trk_) or tracking_code, preferring tracker_id, and add carrier when a tracking_code is ambiguous. Returns the most recent scans.
insurances
ChatGPTCheck standalone insurance coverage. Pass at most one of insurance_id (ins_) or tracking_code to show one policy, which ignores the date window and cursors, or neither to list policies in a date window.
insure_shipment
ChatGPTAdd insurance to one label that was already bought. This debits the postage wallet. It does not show whether a payment method refilled the wallet. The user should approve the amount first. A default insurance amount may already have covered the shipment at buy, which shows on the shipment. Coverage chosen at purchase time is the insurance argument on buy_shipment.
list_carrier_accounts
ChatGPTList the carrier accounts connected to this EasyPost account, by name and type. Credentials are never returned.
list_payment_methods
ChatGPTBrand, last4, and priority of the payment methods on this account. Read only: this cannot add, remove, or change a card or bank account. These methods refill the postage wallet. A label or insurance charge debits that wallet. The response has no wallet balance and no remaining credit, and it does not show whether the wallet was refilled.
list_shipments
ChatGPTList this user's shipments, newest first. Set start_datetime and end_datetime (ISO-8601) for a specific window; EasyPost defaults to the last month. purchased defaults to true, so pass purchased=false to include shipments that were never bought. Pass include_children=true to also cover child accounts. Page with before_id or after_id, never both.
list_trackers
ChatGPTList this user's trackers to see what is in transit. Filter by status or carrier, and by start_datetime / end_datetime (ISO-8601); Core defaults to the last month. To look up one tracking number, use get_tracker instead.
pickups
ChatGPTShow when a carrier is collecting packages. Pass pickup_id (pickup_) to show one pickup, which ignores the date window and cursors, or omit it to list scheduled pickups in a date window.
refunds
ChatGPTCheck the status of postage refund requests. Pass refund_id (rfnd_) to show one request, which ignores the date window and cursors, or omit it to list requests in a date window. This only reads; it never requests a new refund.
smartrate_delivery_date
ChatGPTCalendar delivery date for each rate on one US domestic shipment, given a planned ship date (YYYY-MM-DD). Metered on every call. The dates on this response are the delivery estimates for that ship date. International shipments are out of scope, and there is no second transit-time tool.
whoami
ChatGPTReturn the EasyPost user identified by the current Bearer access token.
buy_shipment
Claudecarrier_metadata
Claudeclaims
Claudecreate_and_verify_address
Claudecreate_refund
Claudecreate_shipment
Claudecreate_tracker
Claudeget_address
Claudeget_shipment
Claudeget_tracker
Claudeinsurances
Claudeinsure_shipment
Claudelist_carrier_accounts
Claudelist_payment_methods
Claudelist_shipments
Claudelist_trackers
Claudepickups
Clauderefunds
Claudesmartrate_delivery_date
Claudewhoami
Claude