Skip to content
Carrier Services/
List Available Carrier Se...

Scurri Platform API (1.0.0)

This API allows you to manage consignments, including creating, updating, and retrieving details about shipments including labels and customs invoices.

Authentication

All requests must be authenticated using either Basic Auth or API token-based authentication. If you have been provided with an API token, you should use token-based authentication.

API Token

With API token-based authentication, you must include the token in the Authorization header as an API token, e.g. Authorization: token YOUR_API_TOKEN. Failed requests will return a 401 HTTP code with WWW-Authenticate: Basic response header.

Basic Auth

With Basic Auth, you have to send the username and password base64-encoded in the standard Basic manner, e.g. Authorization: Basic YXBpdGVzdDphcGkgcGFzc3dvcmQgdGVzdA==.

Here is some sample code in Python to generate the value of the header: ```python`

import base64 username = 'apitest' password = 'api-test-password' print(base64.b64encode((username + ':' + password).encode()).decode()) YXBpdGVzdDphcGktdGVzdC1wYXNzd29yZA==

Download OpenAPI description
openapi.json
openapi.yaml
Languages
Servers
Mock server
https://docs.scurri.com/_mock/connect/consignments-api/versions/1.0.0/openapi/
Scurri Sandbox Environment
https://sandbox.scurri.co.uk/

Carriers

The Carriers API allows you to query Scurri for the carriers that are enabled in your account.

The result contains the identifier for each carrier, which you can use in the rest of the API calls, whenever a Carrier needs to be specified. The identifier will never change, so this can be called once to get the values.

Operations

Carrier Services

The Carrier Services API allows you to query Scurri for the services that are available for each carrier.

The result contains the identifier for each service, which you can use in the rest of the API calls, whenever a Carrier Service needs to be specified.

Operations

List Available Carrier Services

Request

List all the carrier services for the logged in user

Security
TokenAuth
Path
company_slugstringrequired
Query
enhancementsboolean

Whether to include enhanced services in the response.

package_typesboolean

Whether to include package types in the response.

curl -i -X GET \
  'https://docs.scurri.com/_mock/connect/consignments-api/versions/1.0.0/openapi/_api/v1/company/{company_slug}/carrierservices?enhancements=true&package_types=true' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Request was successful

Bodyapplication/jsonArray [
carrier_idstringrequired

the name of the carrier to which the service belongs

Example: "Generic Carrier"
identifierstringrequired

A unique, human readable, identifier for the service.

Example: "Generic Carrier|Generic Domestic Service GDOM"
namestringrequired

The name of the service

Example: "Next Day"
enhancementsArray of strings

List of enhancements supported by the service. Becomes available when the enhancements query parameter is passed as true.

Example: ["dangerous_goods"]
package_typesArray of strings

List of package types supported by the service. Becomes available when the package_types query parameter is passed as true.

Example: ["parcel"]
]
Response
application/json
[
  {
    "carrier_id": "Generic Carrier",
    "identifier": "Generic Carrier|Generic Domestic Service GDOM",
    "name": "Next Day",
    "enhancements": [ … ],
    "package_types": [ … ]
  }
]

Warehouses

The Warehouses API allows you to retrieve a list of warehouses that you have access to (within a company).

The result contains the identifier for each warehouse, which you can use in the rest of the API calls, whenever a Warehouse needs to be specified.

Operations

Consignments

This group of API calls allow you to interact with your consignments in Scurri. You can list and search through them, create new ones, update existing ones, and retrieve their details. To see consignment documents, go to the Consignment Documents section.

Operations

Consignment Documents

You can use this API call to get the label and any customs invoice documents required for a specific consignment, if required.

Keep in mind that a label will be created for each package of the consignment.

Operations

Manifests

The manifest process marks a list of consignments as ready to be picked up by the carrier. A manifest always refers to a specific warehouse and carrier. Scurri abstracts away the necessary actions and documentation a carrier needs and presents a common interface for the manifest process.

The endpoints in this section allow you to create a manifest for given consignments, and retrieve any relevant documents

Operations