Receiving a response from the CCJ web service

When a request is made, the response will be returned in sub-second time. Responses will return the details of any County Court Judgement (CCJ) records which have been matched against the request parameter values provided; or highlight that there are no matches; or, in the event of an error, will return an error message.

Responses are provided as JSON encoded objects containing response parameters, the possible values of which are highlighted below.

Response Parameters

Parameter Data Type Format Provided Notes
title Alpha MR, MRS, MISS, MS
20 characters max
The title of the individual on the CCJ record
forename Alpha A-Z, -
70 characters max
The forename of the individual on the CCJ record
middle Alpha A-Z, -
32 characters max
The middle name of the individual on the CCJ record
surname Alpha A-Z, -
32 characters max
The surname of the individual on the CCJ record
name Alpha A-Z, -
140 characters max
This parameter provides the name on the CCJ record in full (forename, middle name and surname).
address1 Alphanumeric A-Z, 0-9, -
64 characters max
The first line of the address as listed on the CCJ record.
address2 Alphanumeric A-Z, 0-9, -
64 characters max
The second line of the address as listed on the CCJ record. (Where available)
address3 Alphanumeric A-Z, 0-9, -
64 characters max
The third line of the address as listed on the CCJ record. (Where available)
address4 Alphanumeric A-Z, 0-9, -
64 characters max
The fourth line of the address as listed on the CCJ record. (Where available)
address5 Alphanumeric A-Z, 0-9, -
64 characters max
The fifth line of the address as listed on the CCJ record. (Where available)
postcode Alphanumeric A-Z, 0-9,
8 characters max
The postcode as listed on the CCJ record.
amount Float 10,2 The judgement amount required to be paid by the named individual.

For example 382.50.

All amounts are in pounds sterling.
judgementDate Date YYYY-MM-DD The date that the judgement was made.
courtName Alphanumeric 41 characters max The court at which the judgement was made.
highCourtIdentifier Integer 1 – True
0 – False
A flag which indicates whether or not the judging court is a High Court.
caseNumber Alphanumeric A-Z, 0-9
20 characters max
A case reference unique to that particular CCJ.
judgementType Alpha 2 characters max There are several different judgement classification types, which indicate the status of a CCJ.

The 2 character codes, along with their definitions, are shown below.
  • JG: Judgement
  • SS: Satisfaction
  • SA: Cancellation
  • AO: Administration Order
  • AS: Satisfaction
  • C1: Revocation
  • C2: Cancellation
  • J: Judgement
  • C: Set aside
dateEnd Date YYYY/MM/DD The date at which the individual fulfilled their obligations under the judgement.
Source Alpha 3 characters max A code highlighting the source of the data.
matchType Alpha 30 characters max How the CCJ web service matched the request to CCJ records e.g.

NameAddress – this indicates the system matched by name and address.
requestReference Alphanumeric a-z, A-Z, 0-9, - , _
32 characters max
The unique reference associated with the original request – allowing you to identify which request has generated the response.

Once you receive a response, you can then present/use these values to suit your business needs.

Terms and conditions apply

Tracesmart Ltd is now a LexisNexis company and operates under the trading name of LexisNexis. Tracesmart Ltd is incorporated and registered in England and Wales with company number 3827062 and whose registered office is at Global Reach, Dunleavy Drive, Cardiff CF11 0SN. Tracesmart Ltd is authorised and regulated by the Financial Conduct Authority with firm reference number 565961.