Error Codes Reference

Complete list of TCF error codes with descriptions and recommended actions.

Client Errors

Code	HTTP	Description
`INVALID_ENVELOPE`	400	Message envelope failed JSON Schema validation
`UNSUPPORTED_VERSION`	400	Requested TCF version not supported by server
`UNAUTHORIZED`	401	Missing or invalid authentication credentials
`FORBIDDEN`	403	Authenticated user lacks permission
`RECIPIENT_NOT_FOUND`	404	Recipient ID does not exist
`RATE_LIMITED`	429	Too many requests from this sender
`MESSAGE_TOO_LARGE`	413	Message exceeds maximum size limit

Server Errors

Code	HTTP	Description
`INTERNAL_ERROR`	500	Unexpected server error
`SERVICE_UNAVAILABLE`	503	Server is temporarily overloaded
`GATEWAY_TIMEOUT`	504	Upstream server did not respond in time

Protocol Errors

Code	Description
`VERSION_MISMATCH`	Client and server could not agree on TCF version
`INVALID_CONTENT_TYPE`	Content type not recognised
`SIGNATURE_INVALID`	Message signature verification failed