Error Codes

Error response

Please note that error codes listed here might be outdated. You can also look at the source code for an always up-to-date list

Example response:

{
  "error": {
    "code": 0,
    "message": "string"
  }
}

Error codes and message are sent to clients

Code	Message	API
20002	Query string validation failed.
20003	Body validation failed.
20004	Provided IdP list is less than minimum IdP needed (length of "idp_id_list" is less than "min_idp").	/rp/requests/{namespace}/{identifier}
20005	No IdP found.	/rp/requests/{namespace}/{identifier}
20006	Not enough IdP (the number of IdPs found is less than minimum IdP needed).	/rp/requests/{namespace}/{identifier}
20007	Unable to parse body.	/service/{service_id}
20008	External service: Sign with node key test failed. Node public key could not be found. This node may have not been registered with NDID.	/node/register_callback (API v1) /node/callback
20009	External service: Sign with node master key test failed. Node master public key could not be found. This node may have not been registered with NDID.	/node/register_callback_master (API v1) /node/callback
20010	External service: Decrypt with node key test failed. Node public key could not be found. This node may have not been registered with NDID.	/node/register_callback (API v1) /node/callback
20011	Accessor public key for the input accessor ID could not be found.	/idp/response
20012	Request ID could not be found.	/idp/response /as/data/{request_id}/{service_id}
20013	This namespace is not registered by NDID.	/identity
20014	"accessor_id" is required for mode 3.	/idp/response
20015	"secret" is required for mode 3.	/idp/response
20016	"idp_id_list" is required for mode 1.	/rp/requests/{namespace}/{identifier}
20017	Provided AS list is less than minimum AS needed (length of "as_id_list" is less than "min_as").	/rp/requests/{namespace}/{identifier}
20018	Duplicate service ID in data request list.	/rp/requests/{namespace}/{identifier}
20019	Already created an identity for this user.	/identity
20020	An identity for this user could not be found. It may have not been created yet.	/identity/{namespace}/{identifier}/accessors /identity/{namespace}/{identifier}/ial
20021	Specified ial exceeds maximum ial capability.	/identity /identity/{namespace}/{identifier}/ial
20022	"min_ial" or "min_aal" too low for some services requested.	/rp/requests/{namespace}/{identifier}
20023	Some arguments is missing.	/as/service/{service_id}
20024	Not enough AS (the number of AS offer the service is less than minimum AS needed).	/rp/requests/{namespace}/{identifier}
20025	Request is already closed.	/idp/response /as/data/{request_id}/{service_id}
20026	Request is already timed out.	/idp/response /as/data/{request_id}/{service_id}
20027	Invalid cipher suite.	/identity
20028	Invalid accessor signature.	/idp/response
20029	Malformed secret format.	/idp/response
20030	Duplicate accessor ID.	/identity
20031	Request could not be found / This node has not received the request from message queue.	/idp/response
20036	Body size is too large (greater than limit).
20037	Unknown data request (This node may has not yet received data request from RP or the request does not concern this node).	/as/data/{request_id}/{service_id}
20038	Unknown consent request (This node may has not yet received consent request from RP or the request does not concern this node).	/idp/response
20039	Service ID could not be found in data request list of the request.	/as/data/{request_id}/{service_id}
20040	Invalid or malformed key format.	/identity /node/update
20041	Unsupported key type. Only RSA is allowed.	/identity /node/update
20042	Key type mismatched. Provided key type does not match with given key.	/identity /node/update
20043	Some AS IDs in some services in data request list do not provide the requested service.	/rp/requests/{namespace}/{identifier}
20044	RSA key length is too short. Must be at least 2048-bit.	/identity /node/update
20045	Request for this reference ID is in progress.	/identity /rp/requests/{namespace}/{identifier}
20046	External service: Receive mismatched message after decrypt	/node/register_callback (API v1) /node/register_callback_master (API v1) /node/callback
20047	External service: Cannot connect to external decrypt service or receive malform response	/node/register_callback (API v1) /node/register_callback_master (API v1) /node/callback
20048	External service: Cannot parse JSON response (Decrypted Message)	/node/register_callback (API v1) /node/register_callback_master (API v1) /node/callback
20049	External service: Receive invalid signature	/node/register_callback (API v1) /node/callback
20050	External service: Cannot connect to external sign service or receive malform response	/node/register_callback (API v1) /node/callback
20051	External service: Cannot parse JSON response (Signature node key)	/node/register_callback (API v1) /node/callback
20052	External service: Receive invalid signature for master	/node/register_callback_master (API v1) /node/callback
20053	External service: Cannot connect to external master sign service or receive malform response	/node/register_callback_master (API v1) /node/callback
20054	External service: Cannot parse JSON response (Signature master key)	/node/register_callback_master (API v1) /node/callback
20055	IAL is less than request's minimum IAL	/idp/response
20056	AAL is less than request's minimum AAL	/idp/response

Error from callback response

Example callback response:

{
  "type": "string",
  "reference_id": "string",
  "success":boolean,
  "error": {
    "code": 0,
    "message": "string"
  }
}

Error codes and message are sent to clients

Type	Code	Message	API
create_request_result	25007	Not enough token to make a transaction	/rp/requests/{namespace}/{identifier}
close_request_result
create_identity_request_result	10014	Cannot sign with accessor key by callback	/identity
response_result	20025 20026	Request is already closed. Request is already timed out.	/idp/response
add_or_update_service_result	25018 25028	Service ID could not be found. Unauthorized to register a service (NDID may have not granted you the right to register this service).	/as/service/{service_id}
send_data_result	20025 20026	Request is already closed. Request is already timed out.	/as/data/{request_id}/{service_id}
error (RP)
error (IdP)
error (AS)	20032	Invalid HTTP response status code.	AS client response invalid HTTP status code from /service/{service_id}
	20033 20034 20035	Cannot parse string to JSON. Missing data in AS data response. Invalid data type in AS data response. Expected string.	AS client response HTTP status code 200 with data from /service/{service_id}
update_node_result
update_ial_result
add_accessor_request_result
create_identity_result (API v1 only)
add_accessor_result (API v1 only)