Transport Messages

Create a transport message

post

Authorizations

Body

uidstring · uuidOptionalExample: 1f527452-45f4-11eb-a722-0242ac140004

createdstring · date-timeOptional

Date of creation on our server

Example: 2020-12-22T15:31:39.26167Z

created_devicestring · date-timeOptional

creation_methodstringOptional

typestring · enum · max: 100RequiredPossible values:

document_titlestring · max: 100Optional

Filename or if uploaded by a trucker from the mobile app, the document title is generic, for instance photo.

Example: delivery_note_2105_001

document_typestring · enum · max: 100OptionalPossible values:

documentstring · byteOptional

File content. Use content-type with multipart/form-data value to the header of the request to send a document.

is_attached_to_cmrbooleanOptional

transportstring · uuidRequired

sitestring · uuid | nullableOptional

This field is used for the default values of the field readable_by_company_ids; if null, companies from all Sites of the transport are listed in readable_by_company_ids, otherwise only the company of this Site. Site must exist in this transport. This field is part of a beta feature.

Example: 6d95e434-146c-4b8d-a99c-7ef908238445

readable_by_company_idsinteger[]Optional

A list containing the pk of each company allowed to access the document, every company must be part of the transport. If no values are sent, it will be computed with default values; Carrier, Shipper, Invoiced Customer and Site's pk (see Site field). Once values have been sent, the behavior adding default companies is deactivated. The author company is always added. Only pks of companies from the transport will be added, others will be ignored. This field is part of a beta feature.

Example: [1, 2, 3, 4]

messagestringOptional

message displayed in the activity thread of a transport in the web app and in the mobile app

latitudenumber · floatOptional

Latitude using the decimal GPS coordinates (WGS84). At 7 decimals, the position is accurate around the centimeter.

Example: -52.5561625

longitudenumber · floatOptional

Longitude using the decimal GPS coordinates (WGS84). At 7 decimals, the position is accurate around the centimeter.

Example: 92.896504

referencestring · max: 140Optional

Free text. This reference is searchable in the transports dashboard.

Example: delivery note 123456 client 1

visible_by_everyonebooleanOptional

This field is used to make the transport message public, which makes it visible by all parties of the transport.

readable_by_truckerbooleanOptional

This field is used to allow truckers to see the transport message. Only available for carriers.

Responses

201

Create successful

application/json

post

HTTPcURLJavaScriptPython

POST /api/v4/transport-messages/ HTTP/1.1
Host: api.dashdoc.eu
Authentication: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 653

{
  "uid": "1f527452-45f4-11eb-a722-0242ac140004",
  "created": "2020-12-22T15:31:39.26167Z",
  "created_device": "2025-05-29T02:27:10.642Z",
  "creation_method": "text",
  "author": {
    "display_name": "Adèle Bouvet",
    "company": 1738,
    "pk": 11239
  },
  "type": "note",
  "document_title": "delivery_note_2105_001",
  "document_type": "load_photo",
  "document": "Ynl0ZXM=",
  "is_attached_to_cmr": true,
  "transport": "123e4567-e89b-12d3-a456-426614174000",
  "site": "6d95e434-146c-4b8d-a99c-7ef908238445",
  "readable_by_company_ids": "[1, 2, 3, 4]",
  "message": "text",
  "latitude": -52.5561625,
  "longitude": 92.896504,
  "reference": "delivery note 123456 client 1",
  "visible_by_everyone": true,
  "readable_by_trucker": true
}

201

Create successful

{
  "uid": "1f527452-45f4-11eb-a722-0242ac140004",
  "created": "2020-12-22T15:31:39.26167Z",
  "created_device": "2025-05-29T02:27:10.642Z",
  "creation_method": "text",
  "author": {
    "display_name": "Adèle Bouvet",
    "company": 1738,
    "pk": 11239
  },
  "type": "note",
  "document_title": "text",
  "document_type": "load_photo",
  "document": "https://storage.googleapis.com/dashdoc-media/media/shipments/aabd42eb.png",
  "is_attached_to_cmr": true,
  "transport": "123e4567-e89b-12d3-a456-426614174000",
  "site": "6d95e434-146c-4b8d-a99c-7ef908238445",
  "site_remote_id": "text",
  "readable_by_company_ids": "[1, 2, 3, 4]",
  "message": "text",
  "latitude": -52.5561625,
  "longitude": 92.896504,
  "reference": "delivery note 123456 client 1",
  "visible_by_everyone": true,
  "readable_by_trucker": true
}

Delete a transport message

delete

Authorizations

Path parameters

uidstringRequired

Responses

204

Empty body

delete

HTTPcURLJavaScriptPython

DELETE /api/v4/transport-messages/{uid}/ HTTP/1.1
Host: api.dashdoc.eu
Authentication: YOUR_API_KEY
Accept: */*

204

Empty body

No content

Read a transport message

get

Authorizations

Path parameters

uidstringRequired

Responses

200

Get successful

application/json

get

HTTPcURLJavaScriptPython

GET /api/v4/transport-messages/{uid}/ HTTP/1.1
Host: api.dashdoc.eu
Authentication: YOUR_API_KEY
Accept: */*

200

Get successful

{
  "uid": "1f527452-45f4-11eb-a722-0242ac140004",
  "created": "2020-12-22T15:31:39.26167Z",
  "created_device": "2025-05-29T02:27:10.642Z",
  "creation_method": "text",
  "author": {
    "display_name": "Adèle Bouvet",
    "company": 1738,
    "pk": 11239
  },
  "type": "note",
  "document_title": "text",
  "document_type": "load_photo",
  "document": "https://storage.googleapis.com/dashdoc-media/media/shipments/aabd42eb.png",
  "is_attached_to_cmr": true,
  "transport": "123e4567-e89b-12d3-a456-426614174000",
  "site": "6d95e434-146c-4b8d-a99c-7ef908238445",
  "site_remote_id": "text",
  "readable_by_company_ids": "[1, 2, 3, 4]",
  "message": "text",
  "latitude": -52.5561625,
  "longitude": 92.896504,
  "reference": "delivery note 123456 client 1",
  "visible_by_everyone": true,
  "readable_by_trucker": true,
  "extracted_reference": "AX22"
}

Partially update a transport message

patch

Authorizations

Path parameters

uidstringRequired

Body

uidstring · uuidOptionalExample: 1f527452-45f4-11eb-a722-0242ac140004

createdstring · date-timeOptional

Date of creation on our server

Example: 2020-12-22T15:31:39.26167Z

created_devicestring · date-timeOptional

creation_methodstringOptional

typestring · enum · max: 100OptionalPossible values:

document_titlestring · max: 100Optional

Filename or if uploaded by a trucker from the mobile app, the document title is generic, for instance photo.

document_typestring · enum · max: 100OptionalPossible values:

is_attached_to_cmrbooleanOptional

transportstring · uuidOptional

sitestring · uuid | nullableOptional

This field is used for the default values of the field readable_by_company_ids; if null, companies from all Sites of the transport are listed in readable_by_company_ids, otherwise only the company of this Site. Site must exist in this transport. This field is part of a beta feature.

Example: 6d95e434-146c-4b8d-a99c-7ef908238445

readable_by_company_idsinteger[]Optional

A list containing the pk of each company allowed to access the document, every company must be part of the transport. If no values are sent, it will be computed with default values; Carrier, Shipper, Invoiced Customer and Site's pk (see Site field). Once values have been sent, the behavior adding default companies is deactivated. The author company is always added. Only pks of companies from the transport will be added, others will be ignored. This field is part of a beta feature.

Example: [1, 2, 3, 4]

messagestringOptional

message displayed in the activity thread of a transport in the web app and in the mobile app

latitudenumber · floatOptional

Latitude using the decimal GPS coordinates (WGS84). At 7 decimals, the position is accurate around the centimeter.

Example: -52.5561625

longitudenumber · floatOptional

Longitude using the decimal GPS coordinates (WGS84). At 7 decimals, the position is accurate around the centimeter.

Example: 92.896504

referencestring · max: 140Optional

Free text. This reference is searchable in the transports dashboard. Filled by trucker if document is added from mobile app, by user if document is added from web app, or filled by API request.

Example: delivery note 123456 client 1

visible_by_everyonebooleanOptional

This field is used to make the transport message public, which makes it visible by all parties of the transport.

readable_by_truckerbooleanOptional

This field is used to allow truckers to see the transport message. Only available for carriers.

Responses

200

Update successful

application/json

patch

HTTPcURLJavaScriptPython

PATCH /api/v4/transport-messages/{uid}/ HTTP/1.1
Host: api.dashdoc.eu
Authentication: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 689

{
  "uid": "1f527452-45f4-11eb-a722-0242ac140004",
  "created": "2020-12-22T15:31:39.26167Z",
  "created_device": "2025-05-29T02:27:10.642Z",
  "creation_method": "text",
  "author": {
    "display_name": "Adèle Bouvet",
    "company": 1738,
    "pk": 11239
  },
  "type": "note",
  "document_title": "text",
  "document_type": "load_photo",
  "document": {
    "value": "text",
    "options": {
      "filename": "delivery_note_2105_001"
    }
  },
  "is_attached_to_cmr": true,
  "transport": "123e4567-e89b-12d3-a456-426614174000",
  "site": "6d95e434-146c-4b8d-a99c-7ef908238445",
  "readable_by_company_ids": "[1, 2, 3, 4]",
  "message": "text",
  "latitude": -52.5561625,
  "longitude": 92.896504,
  "reference": "delivery note 123456 client 1",
  "visible_by_everyone": true,
  "readable_by_trucker": true
}

200

Update successful

{
  "uid": "1f527452-45f4-11eb-a722-0242ac140004",
  "created": "2020-12-22T15:31:39.26167Z",
  "created_device": "2025-05-29T02:27:10.642Z",
  "creation_method": "text",
  "author": {
    "display_name": "Adèle Bouvet",
    "company": 1738,
    "pk": 11239
  },
  "type": "note",
  "document_title": "text",
  "document_type": "load_photo",
  "document": "https://storage.googleapis.com/dashdoc-media/media/shipments/aabd42eb.png",
  "is_attached_to_cmr": true,
  "transport": "123e4567-e89b-12d3-a456-426614174000",
  "site": "6d95e434-146c-4b8d-a99c-7ef908238445",
  "readable_by_company_ids": "[1, 2, 3, 4]",
  "message": "text",
  "latitude": -52.5561625,
  "longitude": 92.896504,
  "reference": "delivery note 123456 client 1",
  "visible_by_everyone": true,
  "readable_by_trucker": true,
  "extracted_reference": "AX22"
}