{"uid":"cap_ceyGRrsxPrkW2P04k-kUQ","slug":"apiosk-gateway-shipment-api-execute-f63e36d0","name":"Apiosk Gateway – Shipment API Execute","description":"Pay-per-call API gateway on the x402 protocol (HTTP 402 + USDC on Base). This document covers the gateway's discovery and execution meta-endpoints. Individual provider APIs are reachable at /{api_slug}/{path} and described by GET /{api_slug}/metadata.","url":"https://gateway.apiosk.com/shipment-api/execute","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"string","description":"JSON payload forwarded to the selected operation."},"operation":{"type":"string","description":"Operation id, /path, or METHOD /path selector."}}},"responseSchema":{"type":"object","required":["status","result"],"properties":{"api":{"type":"string"},"cost":{"type":"string"},"result":{"description":"Upstream response body."},"status":{"type":"string"},"latency":{"type":"number"},"operation":{"type":"string"},"upstream_status":{"type":"integer"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.2185","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.19/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.19","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.19","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LmIaBcF0dT4J_8I-BEOZy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.19","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Executes a pay-per-call shipment tracking or logistics operation via the Apiosk x402 gateway, forwarding the request to an upstream shipment API and returning the result.","exampleAgentPrompt":"Can you track my shipment with tracking number 1Z999AA10123456784 — I need to know the current status and estimated delivery date?","exampleUseCases":[{"title":"Real-time package status check","prompt":"What's the current status of my UPS package with tracking number 1Z999AA10123456784? Has it shipped yet and when is it expected to arrive?"},{"title":"E-commerce post-purchase tracking","prompt":"A customer just emailed asking where their order is — the tracking number is 9400111899223397910538. Can you pull the latest shipment events and tell me the last known location?"},{"title":"Delivery confirmation for operations","prompt":"I need to confirm whether the shipment with ID SHIP-2024-98231 has been delivered yet — can you check the carrier and give me the delivery timestamp if available?"}],"resultDescription":"Returns a JSON object containing status, the upstream shipment API response body (tracking events, delivery status, carrier info), the operation performed, HTTP status from the upstream provider, latency in milliseconds, and the cost of the call in USDC.","failureModes":["Invalid or unknown tracking number returns upstream error in result field with non-200 upstream_status","Unsupported operation selector causes a routing error","Malformed JSON payload in the input field causes a parse error","Upstream shipment API is unavailable, resulting in a timeout or 5xx upstream_status","Payment failure on x402 protocol blocks the call before forwarding","Rate limiting by the upstream shipment provider"],"whenToPreferThis":"Use this endpoint when you need programmatic, pay-per-call access to shipment tracking data without managing API keys directly, and when operating within an x402/USDC micropayment workflow. Prefer this over direct carrier APIs when you want a unified gateway interface for logistics queries with transparent per-call pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:59:36.213Z","isFirstParty":false}