Retry Document Upload to Carrier

This endpoint allows retrying the upload of a document to the carrier. This is useful when a previous carrier upload failed.

Document Identifier: The document_identifier path parameter can be either:

  • The document_id of the document
  • The name of the document (URL-encoded if it contains special characters or spaces)

Prerequisites:

  • A carrier must be assigned to the shipment.
  • The document must exist in the shipment.
  • The document must have a valid URL (i.e., it was previously uploaded successfully to Carriyo).
  • The carrier must support document upload.

Important Behavior:

  • This endpoint triggers an asynchronous upload to the carrier.
  • The carrier_upload_status will be set to pending immediately.
  • Once the carrier processes the document, the status will be updated to complete or error.
  • Use webhooks or poll the shipment to get the final upload status.

The shipment_id is used as a path parameter to identify the shipment. Alternatively the merchant provided shipment reference (partner_shipment_reference) can also be used instead of the shipment_id.

SecurityOAuth2-Production or OAuth2-Demo
Request
path Parameters
shipment_id
required
string

The Carriyo shipment ID or the merchant provided partner_shipment_reference.

document_identifier
required
string

The document ID or document name (URL-encoded) to identify the document.

header Parameters
x-api-key
required
string
tenant-id
required
string
Responses
200

Document upload retry initiated successfully. Returns the updated shipment object with carrier_upload_status set to pending.

400

Bad Request - Prerequisites not met.

404

Shipment not found.

post/shipments/{shipment_id}/documents/{document_identifier}/retry
Request samples 
Response samples 
application/json
{
  • "shipment_id": "XYZABC123",
  • "entity_type": "FORWARD",
  • "merchant": "MY_BRAND",
  • "references": {
    },
  • "carrier_account": {
    },
  • "payment": {
    },
  • "insurance": {
    },
  • "collection": {
    },
  • "delivery": {
    },
  • "pickup": {
    },
  • "dropoff": {
    },
  • "items": [
    ],
  • "freight": {
    },
  • "customs": {
    },
  • "charges": [
    ],
  • "parcels": [
    ],
  • "post_shipping_info": {
    },
  • "custom_attributes": { },
  • "order_date": "2022-01-01T09:00:00.000Z",
  • "order_type": "HOME_DELIVERY",
  • "creation_date": "2022-01-01T09:00:00.000Z",
  • "update_date": "2022-01-01T09:00:00.000Z",
  • "confirmation_date": "2022-01-01T09:00:00.000Z",
  • "estimated_process_date": "2019-08-24T14:15:22Z",
  • "promised_delivery_date": "2022-01-01T09:00:00.000Z",
  • "original_promised_delivery_date": "2022-01-01T09:00:00.000Z",
  • "estimated_shipping_cost": {
    },
  • "language": "en",
  • "return_request_id": "rma_123abcXYZ"
}