Search Help Contents:

Topics

Error Codes

Error responses will return the standard HTTP error headers and a JSON body containing the error code and error description.

Example Failure Response

HTTP/1.1 401 Unauthorized

Content-Type: application/json

{

"error_description": "Client authentication failed because client is unknown, no client authentication was included, or an unsupported authentication method was used."

"error": "invalid_client"

}

Error Cases and Descriptions

HTTP	Error Code	Error Description	Troubleshooting
400	invalid_request	The request is missing a required parameter, includes an unsupported parameter value, repeats a parameter, includes multiple credentials, utilizes more than one mechanism for authenticating the client, or is otherwise malformed.	Verify syntax of authorization headers and parameters Verify no duplicate authorization headers Verify parameter values conform to documented range
400	unsupported_grant_type	The authorization grant type is not supported by the authorization server	Verify grant type is included in parameters Verify grant type value conforms to documented requirements Verify no duplicate grant types in parameters
401	invalid_client	Client authentication failed because client is unknown, no client authentication was included, or an unsupported authentication method was used.	Verify request contains authorization header Verify authorization header matches documented requirements for token request Verify client_id and client secret are the values exp.o Visibility Support gave you when you registered for API access Verify client_id:client_secret are base64encoded
401	invalid_token	The access token provided is expired, revoked, malformed, or invalid for other reasons.	Request a new valid token Verify valid token is included in Authorization header as documented Verify a token is required for this endpoint
403	insufficient_scope	The request requires higher privileges than provided by the access token.	This API has only one type of token, so this error should not occur
404	404	HTTP 404 Resource Not Found	Verify the request URL matches the intended endpoint as documented Contact Visibility Support if the URL is correct and this problem persists
405	405	HTTP 405 Method Not Allowed	Verify your request method is supported by this API
429	too_many_requests	The client has exceeded the maximum number of requests for the period	Wait until the beginning of the next period before sending more requests. Contact Visibility Support if the problem persists
500	500	HTTP 500 Internal Server Error	Expeditors API service has experienced some kind of failure. Contact Visibility Support if the problem persists

All information contained herein is business confidential and proprietary and may not be reproduced in any form without advanced

written consent of an authorized officer of the copyright holder.

EULA - End User License Agreement