# Returns & Delivery Intelligence API

> Read supplied orders, addresses, carrier events, and return rates, and calculate only the comparisons those records support.

- Product: https://www.brainiac.software/api/returns-delivery
- Docs: https://www.brainiac.software/api/returns-delivery/docs
- OpenAPI: https://www.brainiac.software/api/returns-delivery/openapi.json
- Contact: support@brainiac.software (https://www.brainiac.software/contact)

## Operations

- POST /api/v1/returns-delivery/exception-classify — $0.04 USDC — Classify delivery exceptions: Classify a supplied carrier code or order status only when it matches a documented token. Any other code stays unrecognized, and no tracking scan is added. Docs: https://www.brainiac.software/api/returns-delivery/docs#returns-delivery-exception-classify
- POST /api/v1/returns-delivery/failed-pattern-detect — $0.05 USDC — Detect failed-delivery patterns: Group supplied failed, undeliverable, refused, or returned orders by postcode, address, or carrier. A pattern needs at least three orders. One failure is not a carrier finding. Docs: https://www.brainiac.software/api/returns-delivery/docs#returns-delivery-failed-pattern-detect
- POST /api/v1/returns-delivery/shipping-address-validate — $0.04 USDC — Validate shipping-address structure: Check that the supplied lines, city, postcode, and country are present, and compare a postcode with a published shape for nine country codes. The check does not confirm that a carrier can deliver. Docs: https://www.brainiac.software/api/returns-delivery/docs#returns-delivery-shipping-address-validate
- POST /api/v1/returns-delivery/return-shipping-cost-calculate — $0.04 USDC — Calculate return shipping cost: Apply one matching caller-supplied rate to a return. A missing rate is not estimated, currencies are not converted, and the result is not a refund. Docs: https://www.brainiac.software/api/returns-delivery/docs#returns-delivery-return-shipping-cost-calculate
- POST /api/v1/returns-delivery/return-reason-analyze — $0.04 USDC — Analyze return reasons: Count supplied return reasons exactly as written. A reason is a pattern only at three or more returns. The reason text is not rewritten and no refund is granted. Docs: https://www.brainiac.software/api/returns-delivery/docs#returns-delivery-return-reason-analyze
- POST /api/v1/returns-delivery/promise-variance — $0.04 USDC — Calculate delivery-promise variance: Subtract the supplied promise timestamp from the supplied delivery timestamp. A missing timestamp is not filled in, and the comparison is not a carrier guarantee. Docs: https://www.brainiac.software/api/returns-delivery/docs#returns-delivery-promise-variance
- POST /api/v1/returns-delivery/return-window-calculate — $0.04 USDC — Calculate a return window: Add the supplied day count to the supplied delivered or ordered date and compare a return request with that end date. No day count is assumed, and an inside date is not a refund entitlement. Docs: https://www.brainiac.software/api/returns-delivery/docs#returns-delivery-return-window-calculate
- POST /api/v1/returns-delivery/logistics-report — $0.12 USDC — Report returns and delivery logistics: Combine supplied exceptions, failed-order groups, address structure, return rates, promise variance, and the return window. The report does not contact a carrier or grant a refund. Docs: https://www.brainiac.software/api/returns-delivery/docs#returns-delivery-logistics-report