Error Codes & Responses

At Nova we distinguish between two status message deliveries:

  1. Delivered by Nova to the webhook1
  2. If you call a resource endpoint Nova provides a status in the response


The webhook will be called with the following format:

    status: 'SUCCESS',
    publicId: '8729424a2e3c6a990e3672f7bf618521abfb0a72699274b2a50e7a497c7d7dc1', // only returned for resellers
    publicToken: '6b986690-458b-11e7-98fb-a71570ea65a6',
    userArgs: '235234224'

If you are a reseller client managing many different end customers, we'll also return the publicId to the webhook for you to be able to identify for which account the report is for.

The Nova Credit webhook will provide one of the following status messages:

Text Description
SUCCESS The applicant has been found in the database overseas. A Nova Credit Passport™ has been generated which you can retrieve with the public_token in the body of this request.
NOT_FOUND The applicant could not be found in the database overseas. There is no Nova Credit Passport™ to retrieve
NOT_AUTHENTICATED The applicant was found but could not be authenticated. There is no Nova Credit Passport™ to retrieve
ERROR An internal error occurred and the Nova Credit Passport™ could not be compiled. Please send a message to with the public_token.

Resource endpoints

When an error occurs while calling the endpoints the Nova servers send back a JSON object with the following format:

    error: 'UNKNOWN_CUSTOMER',
    terminated: true,

The Nova endpoints return the following HTTP status codes and error messages:

Code Text Description
200 - Everything went well and the requested resource is either in the body or in the generic text field depending on the content-type
400 MALFORMED_HEADERS The request headers are incorrectly formatted
400 MISSING_INPUT An input is missing that the endpoint expected
408 REQUEST_TIMEOUT The request timed out
403 UNKNOWN_CUSTOMER The public_id or client_id Nova received in the request from is not recognized
403 UNAUTHORIZED The client_id and secret_key combination is not recognized. Please email support via
403 ORIGIN_UNAUTHORIZED The origin of the request is not whitelisted on the Nova servers for CORS
401 EXPIRED_TOKEN The access_token you're sending in the request headers has expired. Please request a new one
404 INVALID_TOKEN The public_token or access_token is not valid for reasons other than expiration
404 PDF_NOT_FOUND The PDF you're requesting cannot be found when hitting the PDF retrieval endpoint
404 PDF_PENDING The PDF is still being generated and not yet available for review when hitting the PDF retrieval endpoint
500 INTERNAL_ERROR Something went wrong. Please send a note to with additional details so we can investigate

(1) For Nova to inform you that a credit file is ready for pick-up we call a webhook that you provide. The POST call we make contains a status code in it's JSON body. For more information visit the server integration section in our NovaConnect Quickstart guide.

results matching ""

    No results matching ""