Error Handling

HTTP Status Error Codes

These are the standard HTTP status codes used by the Certificate Center APIs:

HTTP Response Status	Resolution
400 Bad Request	This error may be caused by the invalid JSON payload in the request. Inspect the error details included in the response (if any) for further information.
401 Unauthorized	Ensure the authentication token in the HTTP header was included in the request and was valid.
403 Forbidden	This error indicates that the server understood the request but refused to process it.
429 Too Many Requests	This error indicates that you have exceeded the client rate limit. (1K requests/minute)
500 Internal Server Error	The operation should be retried later. If the error persists, reach out to Vertex Support.

Response Error Information

In most cases, the API returns a response with error information in JSON format. For example:

{
	"code": 404,
	"error": "Not Found",
	"message": "No customer found with UUID: f8cf6296-c6b2-44b3-9ec1-7531cef53e26",
	"timestamp": "2025-08-28T12:06:56.648877795Z",
	"path": "/certificate-center/v1/customer/f8cf6296-c6b2-44b3-9ec1-7531cef53e26"
}