MonCargo API 管理画面へ

エラーコード一覧

最終更新日: 2026年01月07日

MonCargo API では、リクエストが失敗した場合にエラーコードを含むレスポンスを返します。このページでは、主要なエラーコードについて解説します。


エラーレスポンスの形式


エラーが発生した場合、以下の形式でレスポンスが返されます。


{
"statusCode": 400,
"code": "エラーコード",
"error": "Bad Request",
"message": "エラーメッセージ"
}

例: UnsupportedTrackingType


船社が指定されたトラッキング種別(Booking No. / B/L No. / Container No.)をサポートしていない場合に返されます。


リクエスト例:


curl -XPOST https://api.moncargo.io/v1/shipments \
-u api:YOUR_API_KEY \
-H 'Content-Type: application/json' \
-d '{
"shippingLine": "SITC",
"trackingType": "BOOKING_NUMBER",
"trackingNumber": "1234567890"
}'

レスポンス例:


{
"statusCode": 400,
"code": "UnsupportedTrackingType",
"error": "Bad Request",
"message": "該当のトラッキング種別はサポートされていません。"
}

エラーコード一覧












エラーコードステータスコード説明
UnsupportedTrackingType400船社が該当のトラッキング種別に非対応
InvalidTrackingNumberFormat400トラッキング番号のフォーマットが不正
InvalidAnyNumberFormat400番号が6文字以上24文字以下の半角英数字でない
InvalidContainerNumberFormat400コンテナ番号の形式が不正(4文字のアルファベット + 7桁の数字)
FST_ERR_VALIDATION400リクエストパラメータが不正
ShipmentAlreadyRegistered400同じトラッキング番号の船荷が既に登録されている
TrackingCountExceeded400追跡数が契約プランの上限を超えている
InvalidAccessToken401APIトークンが無効
AccessDenied401リソースへのアクセス権限がない