> ## Documentation Index > Fetch the complete documentation index at: https://developers.teleship.com/llms.txt > Use this file to discover all available pages before exploring further. # Get tracking details > Get real-time tracking updates for a shipment using its tracking number. **What you receive:** - Current status (e.g., in transit, delivered) - Event history (pickups, scans, delivery attempts) - Estimated delivery date **Perfect for:** Building a branded tracking page or sending proactive shipment notifications. ## OpenAPI ````yaml /api-reference/openapi.json get /api/tracking/{trackingNumber} openapi: 3.0.0 info: title: Teleship description: > Teleship is a leading cross-border logistics provider offering seamless global commerce solutions through our comprehensive API. With Teleship's API, developers can integrate our cross-border shipping services, trade engine, and logistics solutions directly into their applications. **Key Features:** - Cross-border shipping solutions for international commerce - Real-time shipping rates and delivery estimates - End-to-end shipment tracking with detailed status updates - Automated customs compliance and product classification - Real-time event notifications through webhooks **Why Teleship?** - API-first: Developer-friendly integration with comprehensive documentation - Enterprise-ready: Built for businesses of all sizes - Secure: Enterprise-grade security and compliance - Integrated: Seamless connection with e-commerce, ERP, and fulfillment systems Start shipping globally with Teleship's powerful cross-border logistics API. version: 1.0.0 contact: {} servers: - url: https://api.teleship.com security: [] tags: [] paths: /api/tracking/{trackingNumber}: get: tags: - Shipping Services summary: Get tracking details description: >- Get real-time tracking updates for a shipment using its tracking number. **What you receive:** - Current status (e.g., in transit, delivered) - Event history (pickups, scans, delivery attempts) - Estimated delivery date **Perfect for:** Building a branded tracking page or sending proactive shipment notifications. operationId: getTrackingDetails parameters: - name: trackingNumber required: true in: path schema: type: string responses: '200': description: Tracking details content: application/json: schema: $ref: '#/components/schemas/TrackingDto' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ResponseMessagesDto' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ResponseMessagesDto' '404': description: Shipment not found content: application/json: schema: $ref: '#/components/schemas/ResponseMessagesDto' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ResponseMessagesDto' security: - bearer: [] components: schemas: TrackingDto: type: object properties: status: type: string enum: - label_created - created - alert - picked_up - in_transit - delivered - cancelled - delayed - discarded - delivery_event - return_to_sender - terminated - failed shipmentId: type: string trackingNumber: type: string trackingURL: type: string description: tracking URL for the shipment example: https://teleship.com/tracking?trackingNumber=1234567890 customerReference: type: string shipDate: format: date-time type: string example: '2024-01-01T00:00:00.00Z' estimatedDelivery: format: date-time type: string example: '2024-01-01T00:00:00.00Z' events: type: array items: $ref: '#/components/schemas/TrackingEventDto' shipFrom: $ref: '#/components/schemas/OriginDto' shipTo: $ref: '#/components/schemas/DestinationDto' firstMile: $ref: '#/components/schemas/TrackingCarrierDto' lastMile: $ref: '#/components/schemas/TrackingCarrierDto' items: description: >- Items/commodities included in this shipment. Used for partial fulfillment matching. type: array items: $ref: '#/components/schemas/TrackingItemDto' required: - status - shipmentId - trackingNumber - trackingURL - shipDate - estimatedDelivery - events - shipFrom - shipTo ResponseMessagesDto: type: object properties: messages: type: array items: $ref: '#/components/schemas/ErrorResponseDto' required: - messages TrackingEventDto: type: object properties: timestamp: format: date-time type: string code: type: string description: type: string location: type: string required: - timestamp - code OriginDto: type: object properties: name: type: string description: The shipper's name. email: type: string description: Email address for the shipper. phone: type: string description: >- Phone number for the shipper. A valid local phone number including area code or a fully qualified international number. Drivers can use this to coordinate pickup with the sender. company: type: string description: >- Business name. This helps the driver successfully collect and deliver the parcel. address: description: The origin address for the shipment default: line1: '' city: '' postcode: '' country: GB allOf: - $ref: '#/components/schemas/OriginAddressDto' required: - name - address DestinationDto: type: object properties: name: type: string description: The recipient's name. email: type: string description: Email address for the recipient. phone: type: string description: >- Phone number for the recipient. A valid local phone number including area code or a fully qualified international number. Drivers can use this to coordinate pickup with the sender. company: type: string description: >- Business name. This helps the driver successfully collect and deliver the parcel. address: description: The destination address for the shipment default: line1: '' city: '' postcode: '' country: US allOf: - $ref: '#/components/schemas/DestinationAddressDto' required: - name - address TrackingCarrierDto: type: object properties: carrier: type: string trackingNumber: type: string trackingUrl: type: string required: - carrier - trackingNumber TrackingItemDto: type: object properties: sku: type: string description: The SKU of the item title: type: string description: The title/name of the item quantity: type: number description: Quantity of this item in the shipment required: - title - quantity ErrorResponseDto: type: object properties: code: type: number level: type: string enum: - error - warning - info example: error description: Error level default: error timestamp: format: date-time type: string example: '2024-01-01T00:00:00.00Z' message: type: string example: An error occurred details: example: - Missing required field type: array items: type: string required: - code - level - timestamp - message - details OriginAddressDto: type: object properties: line1: type: string description: >- The street address for the location. Do not include the postcode, state, or suburb in this field. line2: type: string description: Second line of the street address for the location. city: type: string description: >- City or town of the location. In certain regions the name here is validated against the postcode, so must be valid and match. state: type: string description: State, province, or territory of the location. postcode: type: string description: Postcode, postal code, or ZIP code of the location. isResidential: type: boolean description: Whether the address is residential. country: type: string description: The country of origin for the shipment enum: - GB - US - AT - BE - DE - ES - FR - IT - LU - NL required: - line1 - country DestinationAddressDto: type: object properties: line1: type: string description: >- The street address for the location. Do not include the postcode, state, or suburb in this field. line2: type: string description: Second line of the street address for the location. city: type: string description: >- City or town of the location. In certain regions the name here is validated against the postcode, so must be valid and match. state: type: string description: State, province, or territory of the location. postcode: type: string description: Postcode, postal code, or ZIP code of the location. isResidential: type: boolean description: Whether the address is residential. country: type: string description: The country of destination for the shipment enum: - US - GB - CA - AU - AT - BE - BG - HR - CY - CZ - DK - EE - FI - FR - DE - GR - HU - IE - IT - LV - LT - LU - MT - NL - PL - PT - RO - SI - SK - ES - SE - CH - IS - LI - 'NO' - NZ - SG - HK - AE - SA required: - line1 - country securitySchemes: bearer: scheme: bearer bearerFormat: JWT type: http ````