Submit a Container for screening

Production

https://api.polestar-production.com

POST

/purpletrac/v1/containers

Registers the container by providing the SCAC code and container number in the body and triggers the screening workflow.

Refer to Container Screening to see how to use this endpoint in a container screening workflow.

Request

Authorization

API Key

Add parameter in query

api_key

Example:

api_key: ********************

API Key

Add parameter in query

username

Example:

username: ********************

Query Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

The container was accepted for screening. Carries the container_screen_id the other Container endpoints take.

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠422Parameter Error

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

cURL

Known carrierDetect the carrier

curl --location 'https://api.polestar-production.com/purpletrac/v1/containers?username=undefined&api_key=%3Capi-key%3E' \
--header 'Content-Type: application/json' \
--data '{
    "container_number": "MRKU1234567",
    "scac": "MAEU",
    "container_reference": "User defined reference field"
}'

Response Example

200 - Screening accepted

{
    "container_screen_id": "e32a3293-b081-4bb6-bd36-436ca204165",
    "scac": "CMDU",
    "container_number": "TGBU6795701",
    "container_reference": "User defined reference field",
    "creation_date": "2023-07-19T11:06:51.482652516Z"
}

Modified at 2026-09-18 08:35:54

Carriers

Get all Container Screening Results