SpotGo
  1. Freight
SpotGo
  • Getting started
    • Introduction
    • Authentication
    • Opportunities vs Orders
    • Mappings
  • Order
    • Orders Processing
    • /api/v1/orders/file
      POST
    • /api/v1/orders
      POST
    • /api/v2/orders/{orderId}
      GET
    • /api/v1/orders/{orderId}/file
      GET
  • Opportunity
    • Opportunities (Freight Qoutes)
    • /api/v1/opportunities
      POST
    • /api/v1/opportunities/file
      POST
    • /api/v1/opportunities/image
      POST
    • /api/v1/opportunities/{opportunityId}
      GET
    • /api/v1/opportunities/{opportunityId}/custom
      GET
    • /api/v1/opportunities/{opportunityId}/default
      GET
  • Freight
    • Freight publish
    • /api/v1/freights
      POST
    • /api/v1/freights/{freightId}
      PUT
    • /api/v1/freights/{freightId}
      DELETE
  • Vehicles
    • /api/v1/vehicles
      POST
    • /api/v1/vehicles
      GET
    • /api/v1/vehicles/{vehicleId}
      PUT
    • /api/v1/vehicles/{vehicleId}
      DELETE
    • /api/v1/vehicles/{vehicleId}
      GET
  • Feedback
    • /api/v1/feedback
  • Webhook
    • Webhooks flow
    • /api/v1/webhooks
    • /api/v1/webhooks
    • /api/v1/webhooks/{subscriptionId}
  • Documents
    • Documents processing
    • /api/v1/documents
    • /api/v1/documents/{documentId}/file
    • /api/v1/documents/invoice/{documentId}
    • /api/v1/documents/receipt/{documentId}
    • /api/v1/documents/cmr/{documentId}
  • AccountManagement
    • /api/v1/accounts
    • /api/v1/accounts/block
  1. Freight

/api/v1/freights

POST
https://api-test.spotgo.eu/api/v1/freights
Freight
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-test.spotgo.eu/api/v1/freights' \
--header 'Content-Type: application/json; x-api-version=1.0' \
--data-raw '{
    "externalNumber": "TEST01",
    "owner": "daniel@spotgo.eu",
    "sources": [
        "1",
        "2",
        "3"
    ],
    "useAlternativeLocations": true,
    "locations": [
        {
            "sequence": 1,
            "type": "Loading",
            "address": {
                "countryCode": "LT",
                "postalCode": "01001",
                "city": "Vilnius",
                "coordinates": {
                    "lattitude": 54.6842,
                    "longitude": 25.2724
                }
            },
            "period": {
                "startDate": "2023-06-25T08:00:00",
                "endDate": "2023-06-25T17:00:00"
            }
        },
        {
            "sequence": 2,
            "type": "Unloading",
            "address": {
                "countryCode": "DE",
                "postalCode": "10115",
                "city": "Berlin"
            },
            "period": {
                "startDate": "2023-06-28T08:00:00",
                "endDate": "2023-06-28T17:00:00"
            }
        }
    ],
    "requirements": {
        "trailerTypes": [
            1,
            3
        ],
        "loadingSide": "All",
        "capacity": 8,
        "pallets": 5,
        "palletsExchange": false,
        "ldm": 5,
        "ftl": false,
        "temperature": {
            "max": 5,
            "min": -5,
            "regime": "Continuous"
        }
    },
    "payment": {
        "from": 500,
        "growTo": 800,
        "term": 30,
        "until": "2023-07-25T19:00:00+00:00",
        "updateRangeInHours": "01:00:00"
    },
    "comments": "Some comments for additional information [public]"
}'
Response Response Example
200 - Example 1
{}

Request

Body Params application/json; x-api-version=1.0
externalNumber
string  | null 
optional
sources
array[integer <int32>] | null 
optional
useAlternativeLocations
boolean 
optional
If true, use alternative locations when publishing freight, hides original locations.
locations
array[object (LocationSubmitModel) {4}]  | null 
optional
sequence
integer <int32>
optional
type
enum<string> 
optional
Allowed values:
LoadingUnloading
address
object (LocationAddressSubmitModel) 
optional
period
object (LocationPeriodSubmitModel) 
optional
requirements
object 
optional
trailerTypes
array[integer <int32>] | null 
optional
vehicleTypes
array[integer <int32>] | null 
optional
loadingSide
enum<string> 
optional
Allowed values:
BackTopSideAll
capacity
number <float>
optional
Weight in tons
pallets
integer <int32> | null 
optional
palletsExchange
boolean 
optional
ldm
number <float> | null 
optional
ftl
boolean 
optional
temperature
object (TemperatureSubmitModel) 
optional
payment
object (PaymentSubmitModel) 
optional
from
number <double>
optional
currency
string  | null 
optional
growTo
number <double> | null 
optional
term
integer <int32> | null 
optional
until
string <date-time> | null 
optional
updateRate
string <date-span> | null 
optional
comments
string  | null 
optional
internalComments
string  | null 
optional
customer
object (CustomerSubmitModel) 
optional
name
string  | null 
optional
price
number <double> | null 
optional
currency
string  | null 
optional
owner
string  | null 
optional
Examples

Responses

🟢200OK
text/plain; x-api-version=1.0
OK
Body
object {0}
🟠400Bad Request
Modified at 2025-05-06 04:57:57
Previous
Freight publish
Next
/api/v1/freights/{freightId}
Built with