HTTP Status Codes

This page lists the HTTP response status codes returned by Lightcast APIs and explains what each response means.

2xx - Success

Status Code	Meaning	Description
200	OK	The request was successfully processed. For `GET` requests, the response includes the requested data. For `POST` or `PUT` requests, the response confirms the operation completed successfully.

These responses indicate an issue with the request sent by the client. The request must be modified before retrying.

Status Code	Meaning	Description
400	Bad Request	The request could not be processed by the server because it is malformed, missing required parameters, or contains invalid values. Review the request structure, parameters, and payload before retrying.
401	Unauthorized	Authentication failed because credentials are missing, expired, or invalid. Ensure a valid access token is included in the request headers.
404	Not Found	The requested endpoint or resource does not exist, or the resource cannot be found with the provided identifier. Verify the URL and request parameters.
413	Payload Too Large	The request body exceeds the maximum size allowed by the API. Reduce the payload size or split the request into smaller parts.
415	Unsupported Content Type	The API does not support the format of the data being sent. Ensure the correct `Content-Type` header is set (for example, application/json).
422	Unprocessable Entity	The request is valid, but one or more values in the request are incorrect or not supported. For example, an invalid search query or an unsupported filter value.
429	Too Many Requests	The request rate has exceeded the allowed limit. For more information, see the Rate Limits and Quotas documentation.

These responses indicate the request was valid, but the server encountered an error while processing it.

Status Code	Meaning	Description
500	Internal Server Error	The server encountered an unexpected condition that prevented it from fulfilling the request. Retry the request later or contact Lightcast support if the issue persists.
502	Bad Gateway	The API received an invalid response from an upstream service. This is typically a temporary issue and may resolve on retry.
503	Service Unavailable	The service is temporarily unavailable due to maintenance or high load. Retry the request after some time.
504	Gateway Timeout	The server did not receive a timely response from an upstream service. Retry the request or reduce request complexity.