TWIN Supply Chain Docs
API ReferenceConsignments

List consignment documents

GET/supply-chain/data-space/consignments/{consignmentId}/documents

Authorization

jwtBearerAuthScheme
AuthorizationBearer <token>

In: header

Path Parameters

consignmentId*string

The identifier of the consignment whose documents are being requested.

Query Parameters

scope?string

The scope of the read: own (documents of the caller's own consignment), shared (only documents other organisations shared with the caller) or all (the union). Defaults to all.

Value in

  • "own"
  • "shared"
  • "all"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/supply-chain/data-space/consignments/CONS-001/documents"
{  "entities": [    {      "id": "string",      "documentId": "string",      "documentCode": "string",      "documentType": "string",      "documentRevision": 0,      "metadata": {        "encodingFormat": "string",        "blobSize": 0,        "fileExtension": "string"      },      "href": "string",      "history": [        {          "id": "string",          "documentRevision": 0,          "href": "string"        }      ]    }  ]}
{  "name": "GeneralError",  "message": "errorMessage",  "properties": {    "foo": "bar"  }}
{  "name": "UnauthorizedError",  "message": "errorMessage"}
{  "name": "InternalServerError",  "message": "errorMessage"}

Returns the documents attached to a consignment: your own plus the ones partners shared about the same consignment, deduplicated by documentId with your own copy winning.

A shared document's href points at the providing organisation's node.