Status codes

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)
408	Request Timeout	The maximum wait time was exceeded without receiving a result
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.

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
114	Dialog error
115	Failed to retrieve the code from the os dialog

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
206	No private key
207	JWT token does not contain an application
208	Not allowed to view the log files
299	Security error

Library errors

Code	Description
300	Failed to load the library
301	Installed GCL incompatible with library version
302	No installed GCL component found

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

Pin Enforcement errors

Code	Description
600	PIN provided when no PIN was expected
601	PIN not provided when it was expected to be present

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
805	Origin and referer header are missing
806	X-Relay-State header is missing
807	Invalid X-Relay-State header

General errors

Code	Description
900	Internal error
901	Invalid configuration
902	Invalid container configuration
903	Container download failed
904	Container download timeout