{"uid":"cap_h1aIGE9elY3XPwiLIfHr_","slug":"suverse-logistics-get-load-current-position-cf190bad","name":"SuVerse Logistics — Get Load Current Position","description":"SuVerse Logistics — get a tracked load's current position (logistics.get_load_position)","url":"https://api.suverse.io/v1/freight/get_load_position","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"loadNumber":{"type":"string"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UWTZXAzKDRZPjPJoHx8lV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current tracked position of a freight load identified by its load number","exampleAgentPrompt":"Where is load number TRK-482910 right now? Can you pull its current position from SuVerse?","exampleUseCases":[{"title":"Real-time shipment visibility for dispatcher","prompt":"I need to know exactly where load 8847231 is right now — can you get me its current position so I can update the customer on their delivery ETA?"},{"title":"Exception alert for delayed freight","prompt":"Load number LDX-990042 was supposed to arrive by noon but it hasn't shown up — can you check where it is on SuVerse so I can figure out if it's just running late?"},{"title":"Fleet tracking dashboard update","prompt":"Pull the current position for load 7723-B so I can update our live tracking board for the operations team."}],"resultDescription":"Returns the current geographic position and tracking status of the specified load, including location data (likely coordinates or address) and potentially movement or status details for the active freight load","failureModes":["Load number not found or invalid — endpoint returns an error indicating the load does not exist","Load has no active tracking data — may return empty or null position if tracking has not started or has ended","Malformed loadNumber input — missing or incorrectly formatted load number returns a validation error","Payment failure — x402 payment of $0.02 USDC not fulfilled, resulting in 402 Payment Required response","Service unavailability — API unreachable or upstream GPS provider down"],"whenToPreferThis":"Use this endpoint when you need the current real-time position of a specific freight load and have its load number. It is ideal for point-in-time location lookups within the SuVerse logistics platform. For historical GPS trip data and analytics over a journey, prefer the freight.trip_telematics sibling endpoint instead. Best suited for dispatchers, brokers, or agents needing a quick location check on a single load.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:32:26.911Z","isFirstParty":false}