{"uid":"cap_2S9wQmoom0XB5Uoca2Cic","slug":"container-exception-evidence-analyzer-636ecb74","name":"Container Exception Evidence Analyzer","description":"Pay-per-call data & tool APIs","url":"https://api.timzinin.com/api/container-exception-evidence","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"enum":["snapshot","synthetic_demo"],"type":"string"},"events":{"type":"array","items":{"type":"object","required":["eventId","containerNumber","eventType","eventTime","receivedAt","source"],"properties":{"source":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._: -]{0,127}$","maxLength":128,"minLength":1},"eventId":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$","maxLength":128,"minLength":1},"eventTime":{"type":"string","pattern":"^(?:\\d{4}-\\d{2}-\\d{2})T(?:\\d{2}:\\d{2}:\\d{2})(?:\\.\\d{1,9})?(?:Z|[+-]\\d{2}:\\d{2})$"},"eventType":{"enum":["booked","received_at_terminal","gate_in","loaded","transshipment","discharged","available_for_pickup","gate_out","picked_up","empty_returned","delivered","eta_update","customer_milestone"],"type":"string"},"reference":{"type":["string","null"],"maxLength":256,"minLength":1},"receivedAt":{"type":"string","pattern":"^(?:\\d{4}-\\d{2}-\\d{2})T(?:\\d{2}:\\d{2}:\\d{2})(?:\\.\\d{1,9})?(?:Z|[+-]\\d{2}:\\d{2})$"},"plannedTime":{"type":["string","null"],"pattern":"^(?:\\d{4}-\\d{2}-\\d{2})T(?:\\d{2}:\\d{2}:\\d{2})(?:\\.\\d{1,9})?(?:Z|[+-]\\d{2}:\\d{2})$"},"containerNumber":{"type":"string","pattern":"^[A-Z]{4}[0-9]{7}$"},"locationUnlocode":{"type":["string","null"],"pattern":"^[A-Z]{2}[A-Z0-9]{3}$"},"plannedLocationUnlocode":{"type":["string","null"],"pattern":"^[A-Z]{2}[A-Z0-9]{3}$"}},"additionalProperties":false},"maxItems":50000,"minItems":1},"watchId":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$","maxLength":128,"minLength":1},"containers":{"type":"array","items":{"type":"object","required":["containerNumber"],"properties":{"carrier":{"type":["string","null"],"pattern":"^[A-Za-z0-9][A-Za-z0-9._:/ -]{0,127}$","maxLength":128,"minLength":1},"freeTimeEnd":{"type":["string","null"],"pattern":"^(?:\\d{4}-\\d{2}-\\d{2})T(?:\\d{2}:\\d{2}:\\d{2})(?:\\.\\d{1,9})?(?:Z|[+-]\\d{2}:\\d{2})$"},"promisedEta":{"type":["string","null"],"pattern":"^(?:\\d{4}-\\d{2}-\\d{2})T(?:\\d{2}:\\d{2}:\\d{2})(?:\\.\\d{1,9})?(?:Z|[+-]\\d{2}:\\d{2})$"},"billOfLading":{"type":["string","null"],"pattern":"^[A-Za-z0-9][A-Za-z0-9._:/ -]{0,127}$","maxLength":128,"minLength":1},"bookingNumber":{"type":["string","null"],"pattern":"^[A-Za-z0-9][A-Za-z0-9._:/ -]{0,127}$","maxLength":128,"minLength":1},"originUnlocode":{"type":["string","null"],"pattern":"^[A-Z]{2}[A-Z0-9]{3}$"},"containerNumber":{"type":"string","pattern":"^[A-Z]{4}[0-9]{7}$"},"destinationUnlocode":{"type":["string","null"],"pattern":"^[A-Z]{2}[A-Z0-9]{3}$"}},"additionalProperties":false},"maxItems":1000,"minItems":1},"sourceStatus":{"enum":["complete","partial","unavailable"],"type":"string"},"continuationState":{"type":["object","null"]},"rightsAttestation":{"type":"object","required":["customerControlsOrIsAuthorizedToUseData","noCredentialsOrSecretsSubmitted","unfetchedReferencePolicyAccepted","attestedAt","attestorId"],"properties":{"attestedAt":{"type":"string","pattern":"^(?:\\d{4}-\\d{2}-\\d{2})T(?:\\d{2}:\\d{2}:\\d{2})(?:\\.\\d{1,9})?(?:Z|[+-]\\d{2}:\\d{2})$"},"attestorId":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$","maxLength":128,"minLength":1},"noCredentialsOrSecretsSubmitted":{"type":"boolean"},"unfetchedReferencePolicyAccepted":{"type":"boolean"},"customerControlsOrIsAuthorizedToUseData":{"type":"boolean"}},"additionalProperties":false},"tariffAssumptions":{"type":"object","required":["currency","demurragePerDay","detentionPerDay"],"properties":{"currency":{"enum":["USD"],"type":"string"},"demurragePerDay":{"type":"number","maximum":1000000,"minimum":0},"detentionPerDay":{"type":"number","maximum":1000000,"minimum":0}},"additionalProperties":false}}},"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_RCxELvD4e8pLEW2DHSwOc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes a stream of container tracking events to detect and surface exception evidence — anomalies, delays, and milestone deviations in shipping container movements.","exampleAgentPrompt":"Analyze these container tracking events for MSCU1234567 — I sent them as a snapshot — and tell me if there are any exceptions or anomalies, like missed milestones or delays between gate-in and loading.","exampleUseCases":[{"title":"Detect free-time expiry risk","prompt":"I have a batch of container events for TCKU9876543 with a free time end tomorrow — run them through snapshot mode and flag any exception evidence suggesting it won't be picked up in time."},{"title":"Audit transshipment delay evidence","prompt":"We got a series of transshipment and discharged events for containers HLXU1111111 and GESU2222222 — can you analyze them and surface any evidence of delays or exceptions between the transshipment and the next loading event?"},{"title":"Validate synthetic demo exception patterns","prompt":"Run the container-exception-evidence endpoint in synthetic_demo mode and show me what kinds of exceptions it typically detects, using watch ID 'demo-watch-001'."}],"resultDescription":"Returns structured exception evidence for each analyzed container, including identified anomalies (e.g. missed milestones, unexpected gaps between events, ETA deviations, free-time overruns), the specific events that triggered each exception, and confidence signals about the severity or type of deviation.","failureModes":["Invalid container number format (must match ^[A-Z]{4}[0-9]{7}$) returns validation error","Events array empty or exceeds 50,000 item limit","Invalid or malformed ISO 8601 timestamps in eventTime or receivedAt","Unknown or missing required event fields (eventId, containerNumber, eventType, eventTime, receivedAt, source)","Invalid UN/LOCODE format in locationUnlocode","Payment failure via x402 protocol returns 402 before processing","watchId pattern mismatch causes request rejection"],"whenToPreferThis":"Choose this endpoint when you have raw container tracking event streams and need to programmatically identify exceptions, anomalies, or deviations from planned logistics milestones. It is particularly well-suited for supply chain agents that ingest carrier tracking feeds and need to triage which containers require human attention. Prefer this over generic ETL or monitoring tools when your data conforms to standard container event types (gate-in, loaded, discharged, etc.) and you need structured exception evidence rather than raw event pass-through.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:44:38.400Z","isFirstParty":false}