{ "opencollection": "1.0.0", "info": { "name": "Address Shipments API", "version": "3.0.0" }, "items": [ { "info": { "name": "Shipments", "type": "folder" }, "items": [ { "info": { "name": "Create and announce a shipment synchronously", "type": "http" }, "http": { "method": "POST", "url": "https://panel.sendcloud.sc/api/v3/shipments/announce", "headers": [ { "name": "Sendcloud-Partner-Id", "value": "" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "docs": "This endpoint **announces a shipment synchronously** under your API credentials." }, { "info": { "name": "Retrieve shipments", "type": "http" }, "http": { "method": "GET", "url": "https://panel.sendcloud.sc/api/v3/shipments", "params": [ { "name": "parcel_status", "value": "", "type": "query", "description": "Returns shipments that have the requested status. For a list of possible statuses, see the [Retrieve a list of parcel statuses](/api/v3/parcel-statuses/retrieve-a-list-of-parcel-statuses) endpoint." }, { "name": "tracking_number", "value": "", "type": "query", "description": "Returns shipments that match a specified tracking number" }, { "name": "external_reference_id", "value": "", "type": "query", "description": "Returns shipments that match a specified external reference" }, { "name": "order_number", "value": "", "type": "query", "description": "Returns a shipment that matches a specific `order_number` property from your shipments" }, { "name": "integration_id", "value": "", "type": "query", "description": "Returns all shipments that matches a specific `integration_id` property from your shipments" }, { "name": "updated_before", "value": "", "type": "query", "description": "Returns all shipments which have been updated in our system before a given time. Use the ISO 8601 datetime format." }, { "name": "updated_after", "value": "", "type": "query", "description": "Returns all shipments which have been updated in our system after a given time. Use the ISO 8601 datetime format." }, { "name": "announced_before", "value": "", "type": "query", "description": "Returns all shipments which have been announced to the carrier before the given time. Use the ISO 8601 datetime format." }, { "name": "announced_after", "value": "", "type": "query", "description": "Returns all shipments which have been announced to the carrier after the given time. Use the ISO 8601 datetime format." }, { "name": "ids", "value": "", "type": "query", "description": "Filter results using a comma-separated list of *parcels IDs*. The list may not contain more than 100 IDs." }, { "name": "shipment_uuids", "value": "", "type": "query", "description": "Filter results using a comma-separated list of *shipments IDs*. The list may not contain more than 100 IDs." }, { "name": "cursor", "value": "", "type": "query", "description": "The cursor query string is used as the pivot value to filter results. If no value is provided, the first page of results will be returned. To get this value, you must encode the offset, reverse and position into a base64 string.\n\nThere are 3 possible parameters to encode:\n- `o`: Offset\n- `r`: Reverse\n- `p`: Position\n \nFor example, `r=1&p=300` encoded as a base64 string would be `cj0xJnA9MzAw`. The query string would then be `cursor=cj0xJnA9MzAw`." }, { "name": "page_size", "value": "", "type": "query", "description": "The maximum number of items to be returned in the response." } ], "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "docs": "This endpoint allows you to retrieve a list of all the shipments which you have created or imported into your Sendcloud account under your API credentials. You can filter the results based on several query parameters.\n\nThis endpoint uses cursor-based pagination via `Link` headers. See [Pagination](/api/v3/pagination) for details." }, { "info": { "name": "Create and announce a shipment asynchronously", "type": "http" }, "http": { "method": "POST", "url": "https://panel.sendcloud.sc/api/v3/shipments", "headers": [ { "name": "Sendcloud-Partner-Id", "value": "" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "docs": "This endpoint **announces a shipment asynchronously** under your API credentials." }, { "info": { "name": "Create a shipment with rules and/or defaults and announce it synchronously", "type": "http" }, "http": { "method": "POST", "url": "https://panel.sendcloud.sc/api/v3/shipments/announce-with-shipping-rules", "headers": [ { "name": "Sendcloud-Partner-Id", "value": "" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "docs": "Create and announce a shipment applying shipping rules and/or defaults" }, { "info": { "name": "Create a shipment with rules and/or defaults and announce it asynchronously", "type": "http" }, "http": { "method": "POST", "url": "https://panel.sendcloud.sc/api/v3/shipments/create-with-shipping-rules", "headers": [ { "name": "Sendcloud-Partner-Id", "value": "" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "docs": "Create and announce a shipment applying shipping rules and/or defaults asynchronously." }, { "info": { "name": "Validate an address", "type": "http" }, "http": { "method": "POST", "url": "https://panel.sendcloud.sc/api/v3/addresses/validate", "headers": [ { "name": "Sendcloud-Partner-Id", "value": "" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "docs": "This address validation endpoint allows you to validate shipping addresses before using them.\nBy validating addresses in advance, you can ensure that the shipping information is accurate and complete,\nreducing the risk of delivery issues and improving overall shipping efficiency.\nProviding the carrier helps to tailor the address validation process according to specific carrier requirements.\nUsing additional validation methods can further enhance the accuracy of the address verification.\n\nThe def" }, { "info": { "name": "Retrieve a shipment", "type": "http" }, "http": { "method": "GET", "url": "https://panel.sendcloud.sc/api/v3/shipments/:id", "params": [ { "name": "id", "value": "", "type": "path", "description": "The id of the shipment you want to retrieve" } ], "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "docs": "This endpoint allows you to retrieve a specific shipment created under your Sendcloud credentials, based on the shipment `id`." }, { "info": { "name": "Cancel a shipment", "type": "http" }, "http": { "method": "POST", "url": "https://panel.sendcloud.sc/api/v3/shipments/:id/cancel", "params": [ { "name": "id", "value": "", "type": "path", "description": "ID of the shipment" } ], "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "docs": "Use this endpoint to cancel an announced shipment, if the carrier supports cancellation." }, { "info": { "name": "Retrieve a return portal URL", "type": "http" }, "http": { "method": "GET", "url": "https://panel.sendcloud.sc/api/v3/shipments/:id/return-portal-url", "params": [ { "name": "id", "value": "", "type": "path", "description": "ID of the shipment" } ], "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "docs": "Retrieve a return portal link for a specific shipment using the shipment's id." }, { "info": { "name": "Retrieve a list of shipments", "type": "http" }, "http": { "method": "GET", "url": "https://panel.sendcloud.sc/api/v3/integrations/:id/shipments", "params": [ { "name": "id", "value": "", "type": "path", "description": "The id of the integration to which the shipments belong" }, { "name": "cursor", "value": "", "type": "query", "description": "The cursor query string will be used as the pivot value to filter results. If no value is provided, the service must return the first page. The value is Base64 encoded GET parameters. example:\n For a cursor string there are 3 possible parameters to encode:\n - o: Offset\n - r: Reverse\n - p: Position\n Combine into GET parameters. Example: r=1&p=300\n Base 64 encoded it would become: cj0xJnA9MzAw\n GET parameter in url would be https://some.url.com/api/endpoint/?cursor=cj0xJnA9MzAw\n" }, { "name": "start_date", "value": "", "type": "query", "description": "Displays orders from the given `start_date`, including the set date. It defaults to one year ago." }, { "name": "end_date", "value": "", "type": "query", "description": "Displays orders up to the given `end_date`, including the set date. It defaults to the current date." }, { "name": "external_order_ids", "value": "", "type": "query", "description": "Filters results to shipments where their `external_order_id` matches one of the user provided ones." }, { "name": "external_shipment_ids", "value": "", "type": "query", "description": "Filters results to shipments where their `external_shipments_id` matches one of the user provided ones." }, { "name": "shipping_rules", "value": "", "type": "query", "description": "Enable shipping rules when retrieving orders. This will have an impact on the `allowed_shipping_methods`." }, { "name": "order_number", "value": "", "type": "query", "description": "Filters results to shipments on `order_number`." }, { "name": "sender_address", "value": "", "type": "query", "description": "Allows to specify a sender address id to display proper `allowed_shipping_methods`." } ], "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "docs": "Retrieve a list of orders that were imported from a specific webshop integration." }, { "info": { "name": "Create or update a list of shipments", "type": "http" }, "http": { "method": "POST", "url": "https://panel.sendcloud.sc/api/v3/integrations/:id/shipments", "params": [ { "name": "id", "value": "", "type": "path", "description": "The id of the integration to which the shipments belong" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "docs": "Insert shipments (or 'orders') into an API integration from your shop system, and have them appear in your Sendcloud account." }, { "info": { "name": "Delete a shipment", "type": "http" }, "http": { "method": "POST", "url": "https://panel.sendcloud.sc/api/v3/integrations/:id/shipments/delete", "params": [ { "name": "id", "value": "", "type": "path", "description": "The id of the integration to which the shipments belong" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "docs": "Allows you to delete a shipment from Sendcloud, e.g. if it has been canceled or deleted in your shop system." } ] } ], "bundled": true }