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