# SmartShip > SmartShip (smartship.ro) is a Romanian shipping platform: one account and one API to quote, create, label, track and cancel shipments with multiple couriers (Cargus, DPD, SameDay and easybox lockers, FanCourier, DragonStar, PTT Express, FedEx, SmartShip Delivery), plus cash-on-delivery payouts. Documentation is bilingual (Romanian / English). ## API documentation - [API docs (Markdown, English)](https://smartship.ro/api-docs/markdown?lang=en): full reference — auth, recommended flow, couriers, common objects, all endpoints with examples and error codes - [API docs (Markdown, Romanian)](https://smartship.ro/api-docs/markdown): same content in Romanian - [OpenAPI 3.1 spec](https://smartship.ro/api-docs/openapi.json): machine-readable, best for code generation - [Human-readable docs](https://smartship.ro/api-docs): interactive page with code samples in cURL, PHP, Node.js, Python ## Own courier contract (BYOC) - [BYOC docs (Markdown, English)](https://smartship.ro/api-docs/byoc/markdown?lang=en): only what differs when shipping on the customer's own courier contract (use_own_contract) - [BYOC OpenAPI spec](https://smartship.ro/api-docs/openapi-byoc.json) ## Key facts - Base URL: https://api.smartship.ro — authentication with the `X-API-KEY` header (key from the SmartShip account: My account → Settings → API). - Every JSON response has `status`: 200 = success; any other value is an error described in `message`. Always check `status`, not only the HTTP code. - Typical flow: /geolocation/cities (locality IDs) → POST /cost (prices) → POST /awb/new (AWB, label link, tracking link) → /awb/status. - AI connector (MCP) for SmartShip accounts: https://mcp.smartship.ro — the account owner enables it in Account settings → AI connector. Reads account data and can create/cancel AWBs; every write requires the user's explicit confirmation in the chat (can be switched to read-only).