Status codes

HTTP Status Codes

T1C-GCL uses the following HTTP response codes when handling a request.

Code	Description	Info
200	Success	The request was successful
400	Bad Request	The request input contains errors (e.g. wrong json)
412	Precondition Failed	An application error occurred while handling the request (e.g. pin blocked)

In case of an error (400 or 412) the response will contain a body with more detailed information about the error:

{
  success: false,
  description: "some error description",
  code: "some error code"
}

All possible values of the codes are described below in "Application Status Codes" The description field contains more information and a stack trace from the exception.

Application Status Codes

Card reader related errors

Code	Description
0	Card reader error
1	No reader found
2	Card reader is not a Belfius reader

Card related errors

Code	Description
100	Card error
101	Card not present
102	Wrong card (not an eID)
103	Wrong pin, 2 tries remaining
104	Wrong pin, 1 try remaining
105	Pin blocked
106	Invalid Pin
107	Verify Pin not supported on reader
108	Application locked
109	Verify Pin cancelled
110	Verify Pin timed out
111	Wrong pin, 4 tries remaining
112	Wrong pin, 3 tries remaining
113	PUK blocked

JWT Security errors

Code	Description
200	JWT token is malformed
201	No valid certificate available
202	JWT token algorithm is not supported
203	JWT token has an incorrect signature
204	JWT token UID is incorrect
205	JWT token is expired

Container and Library errors

Code	Description
300	Failed to load the library

For container errors, the information is provided in the container documentation section.

Session errors

Code	Description
400	Session error
401	No active session
402	Invalid session id

Agent errors

Code	Description
500	Agent error
501	Unknown agent

Input errors

Code	Description
800	Invalid json
801	Invalid arguments
802	Invalid HTTP request
803	X-Authentication-Token header missing
804	Invalid X-Authentication-Token header

General errors

Code	Description
900	Internal error
901	Invalid configuration
902	Invalid container configuration