1. Freight
SpotGo
  • Getting started
    • Introduction
    • Authentication
    • Opportunities vs Orders
    • Mappings
  • Order
    • Orders Processing
    • Integrating Your Order Document Processing: A Guide to Best Practices
    • /api/v1/orders/file
      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
    • Freights
    • /api/v1/freights
      POST
    • /api/v1/freights
      GET
    • /api/v1/freights/share
      POST
    • /api/v1/freights/{freightId}
      GET
    • /api/v1/freights/{freightId}
      PUT
    • /api/v1/freights/archive/{freightId}
      GET
    • /api/v1/freights/{freightId}
      DELETE
    • /api/v1/freights/archive
      GET
  • Vehicles
    • /api/v1/vehicles
    • /api/v1/vehicles
    • /api/v1/vehicles/{vehicleId}
    • /api/v1/vehicles/{vehicleId}
    • /api/v1/vehicles/{vehicleId}
  • Feedback
    • /api/v1/feedback
  • Webhook
    • Webhooks flow
    • /api/v1/webhooks
    • /api/v1/webhooks
    • /api/v1/webhooks/{subscriptionId}/reset
    • /api/v1/webhooks/{subscriptionId}/notify
    • /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}
    • /api/v1/documents/fine/{documentId}
    • /api/v1/documents/insurance/{documentId}
  • AccountManagement
    • /api/v1/accounts
    • /api/v1/accounts/block
  • DriversDocuments
    • /api/v1/drivers-documents
    • /api/v1/drivers-documents/{documentId}
  • CarrierPortal
    • Integration flows
    • Webhooks
    • Document Upload
    • /api/v1/orders
    • /api/v1/orders/{orderId}
    • /api/v1/orders/{orderId}
    • /api/v1/orders/{orderId}
    • /api/v1/orders/upsert
    • /api/v1/orders/query
    • /api/v1/orders/{orderId}/documents/{documentId}/content
    • /api/v1/orders/{orderId}/documents/{documentId}/status
  • Classification
    • /api/v1/classifications/email
  • DocumentCollections
    • /api/v1/document-collections/files
    • /api/v1/document-collections/{collectionId}
    • /api/v1/document-collections/{collectionId}/documents/{documentId}/items/{itemId}/file
    • /api/v1/document-collections/{collectionId}/documents/{documentId}/file
  • FreightOffers
    • /api/v1/freights/offers
    • /api/v1/freights/{freightId}/offers/{offerId}
  • Schemas
    • Schemas
    • WebhookSubscriptionNotificationsRequest
    • CarrierOrderStatus
    • CarrierSubmitModel
    • CarrierViewModel
    • DocumentRejectionReason
    • AlternativePlacesRangeSubmitModel
    • ApiKeyAuthentication
    • BasicAuthentication
    • CustomOpportunityApiAddressModel
    • CustomOpportunityApiDescriptionModel
    • CustomOpportunityApiGeoCoordinateModel
    • CustomOpportunityApiLocationModel
    • CustomOpportunityApiModel
    • CustomOpportunityApiRequirementsModel
    • CustomOpportunityApiViewModel
    • CustomerCustomerListResponse
    • CustomerCustomerViewModel
    • CustomerCustomersSubmitModel
    • CustomerSubmitModel
    • DocumentFileType
    • DocumentStatus
    • DocumentsConvertSubmitModel
    • DocumentsConvertViewModel
    • ErrorItemViewModel
    • ErrorViewModel
    • FeedbackSubmitItemModel
    • FeedbackSubmitModel
    • FeedbackTransactionType
    • FeedbackType
    • FreightCreateViewModel
    • FreightSubmitModel
    • FreightUpdateSubmitModel
    • InvoiceApiAddress
    • InvoiceApiLine
    • InvoiceApiModel
    • InvoiceApiParty
    • InvoiceApiTotal
    • InvoiceResponseViewModel
    • LoadingSideTypes
    • LoadingType
    • LocationAddressSubmitModel
    • LocationCoordinatesSubmitModel
    • LocationPeriodSubmitModel
    • LocationSubmitModel
    • Oauth2Authentication
    • OpportunityApiAddress
    • OpportunityApiCargo
    • OpportunityApiCoordinates
    • OpportunityApiLocation
    • OpportunityApiModel
    • OpportunityApiPayment
    • OpportunityApiPeriod
    • OpportunityApiRequirements
    • OpportunityApiTemperature
    • OpportunityApiTransitInfo
    • OpportunityApiViewModel
    • OpportunityResultModel
    • OpportunityStatus
    • OpportunitySubmitModel
    • OrderConvertSubmitModel
    • OrderConvertViewModel
    • OrderDataViewModel
    • OrderStatus
    • OrderTypes
    • OrderViewCargo
    • OrderViewLocation
    • OrderViewLocationCoordinates
    • OrderViewModel
    • OrderViewParty
    • OrderViewPayments
    • PaymentSubmitModel
    • ProblemDetails
    • RegimeTypes
    • RequirementsSubmitModel
    • SpotGoDocumentType
    • TemperatureSubmitModel
    • VehicleAddressSubmitModel
    • VehicleLoadingLocationSubmitModel
    • VehicleLocationPeriodSubmitModel
    • VehicleRequirementsSubmitModel
    • VehicleResultViewModel
    • VehicleSubmitModel
    • VehicleUnloadingLocationSubmitModel
    • WebhookAuthType
    • WebhookAuthentication
    • WebhookEventType
    • WebhookItemViewModel
    • WebhookSubscriptionRequest
    • WebhookSubscriptionResponse
    • WebhookViewModel
    • AccountBlockSubmitModel
    • AccountSubmitModel
    • AccountViewModel
    • InsuranceApiModel
    • InsuranceCompanyApi
    • InsuranceResponseViewModel
    • FreightShareSubmitModel
    • FreightShareViewModel
    • FreightViewModel
    • FreightsViewModel
    • DriverDocumentTypeResponse
    • DriversDocumentApiModel
    • DriversDocumentsConvertViewModel
    • DriversDocumentsViewModel
    • DocumentStatusChangeSubmitModel
    • ApiAutomationStatus
    • ExternalErrorItemViewModel
    • ExternalErrorViewModel
    • AutomationResultsViewModel
    • OrderDetailsSubmitModel
    • AutomationStartedViewModel
    • OrderDetailsViewModel
    • BankInfoApi
    • OrderDocumentStatus
    • OrderDocumentViewModel
    • CargoSubmitModel
    • OrderLocationSubmitModel
    • CargoViewModel
    • OrderLocationType
    • CmrAttachmentApiModel
    • OrderLocationViewModel
    • CmrCargoLoadingApiModel
    • OrderQueryItemViewModel
    • CmrCargoUnloadingApiModel
    • OrderQuerySubmitModel
    • CmrCarrierApiModel
    • OrderQueryViewModel
    • CmrDriverApiModel
    • OrderShareViewModel
    • CmrGoodsApiModel
    • OrderSubmitModel
    • CmrIssueApiModel
    • OrderUpsertViewModel
    • CmrPartyApiModel
    • CmrPaymentApiModel
    • PositionSubmitModel
    • CmrReiceivalApiModel
    • CmrResponseApiModel
    • QueryDateRange
    • CmrResponseViewModel
    • CollectionDocumentType
    • ContractCarrierApiModel
    • DocumentCollectionDataViewModel
    • DocumentCollectionDocumentDataViewModel
    • DocumentCollectionDocumentViewModel
    • DocumentCollectionStatus
    • DocumentCollectionUploadViewModel
    • DocumentCollectionViewModel
    • DocumentPagesViewModel
    • DocumentsConvertSubmitModelBase
    • DriverAddressModel
    • DriverFinesSubmitModel
    • DriverGender
    • DriverLicenseDetailsModel
    • DriverModel
    • EmailClassificationCategory
    • EmailClassificationSubmitModel
    • EmailClassificationTypes
    • EmailClassificationViewModel
    • ExchangeRateApi
    • FineApiModel
    • FineResponseViewModel
    • FreightAdditionalDataSubmitModel
    • FreightCreatorViewModel
    • FreightListViewModel
    • FreightLocationViewModel
    • FreightOfferCreatorViewModel
    • FreightOfferViewModel
    • FreightOffersViewModel
    • FreightTargetPriceSubmitModel
    • FreightType
    • InsuranceAmountBreakdownApi
    • IntegrationDocumentFinishedSubmitModel
    • IntegrationDocumentTypes
    • IntegrationDocumentsProcessStatus
    • InvoiceLineType
    • LambdaAuthentication
    • LocationAddressViewModel
    • LocationCoordinatesViewModel
    • LocationGroupTypes
    • LocationPeriodViewModel
    • OfferStatus
    • OrderAccountingConvertViewModel
    • OrderCargoValue
    • OrderDriver
    • OrderPriceBreakdown
    • OrderSubType
    • OrderViewPartyContactPerson
    • PaymentTypes
    • PaymentViewModel
    • ReceiptApiModel
    • ReceiptItemApiModel
    • ReceiptMerchantApiModel
    • ReceiptResponseViewModel
    • RefrigeratorUnitMode
    • RequirementsViewModel
    • SqsAuthentication
    • TemperatureViewModel
  1. Freight

/api/v1/freights

POST
https://api-test.spotgo.eu/api/v1/freights

Request

Body Params application/json; x-api-version=1.0

Examples

Responses

🟢200OK
text/plain; x-api-version=1.0
OK
Bodytext/plain; x-api-version=1.0

🟠400Bad Request
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '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,
    "alternativeLocationsRange": { // Optional
        "fromKm": 5,
        "toKm": 15
    },
    "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"
        },
        "capabilities": [1]
    },
    "payment": {
        "from": 500,
        "growTo": 800,
        "term": 30,
        "until": "2023-07-25T19:00:00+00:00",
        "updateRate": "01:00:00"
    },
    "totalDistance": 1230,
    "comments": "Some comments for additional information [public]"
}'
Response Response Example
200 - Example 1
{}
Modified at 2026-04-03 14:34:07
Previous
Freights
Next
/api/v1/freights
Built with