Skip to content
Warehouses/
List Available Warehouses

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

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

List Available Warehouses

Request

Security
TokenAuth
Path
company_slugstringrequired
curl -i -X GET \
  'https://docs.scurri.com/_mock/connect/consignments-api/versions/1.0.0/openapi/_api/v1/company/{company_slug}/warehouses' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Request was successful

Bodyapplication/jsonArray [
identifierstringrequired

A unique, human readable, identifier for the service.

Example: "api-test-company|Test Warehouse"
namestringrequired

The name of the warehouse.

Example: "Test Warehouse"
]
Response
application/json
[
  {
    "identifier": "api-test-company|Test Warehouse",
    "name": "Test Warehouse"
  }
]

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