GBG Developers

sdfsdfsdf

some text

.red { fill: #b0013a; }

Existing Verification

Post /verify/people/v4/{person-id}

Submits a person's details to verify them against a preset list of checks. This call should be used where a person-id has been created from a previous verification step.

Mandatory fields are highlighted
Path Parameters
Name Type Description
person-id string

Use to identify the verification made against a person

Example: 9d75d85e-f7bc-4d22-a93b-60c04881193d
Header Parameters
Name Type Description
Authorization string

A JWT token to allow access

cleanse-address boolean

Specifies if the addresses should be cleansed by our Loqate product to improve the verification results.

Example: true
journey-id string

Used by ID3 to pick out the preconfigured list of checks to do against this submission

Example: 9d75d85e-f7bc-4d22-a93b-60c04881193d
journey-version integer

Used by ID3 to pick out the preconfigured list of checks to do against this submission

Example: 1
customer-reference string

Allows you to submit a UUID that can be used to track this verification

Example: 9d75d86e-f7bc-4d22-a93b-59c04881193f
triangulation-verification-id string

ID of a previous verification step which the current verification step should be compared to. The matching person-id header must be populated to use this option.

Example: 9d75d85e-f7bc-4d22-a93b-60c04881193d
Request Body
  • Example
  • Schema
    THIS IS A NULL VALUE
{
  "title": "Mr",
  "firstName": "Dave",
  "middlenames": [
    "Dai"
  ],
  "lastnames": [
    "Jones"
  ],
  "gender": "MALE",
  "birthdate": "2000-01-01",
  "addresses": [
    {
      "type": "CURRENT",
      "address": {
        "premise": "18A",
        "building": "The House",
        "thoroughfare": "The Street",
        "locality": "The Town",
        "postalCode": "CL7 9DF",
        "country": "UK"
      },
      "resident": {
        "from": "2011-11-11"
      }
    },
    {
      "type": "PREVIOUS",
      "address": {
        "lines": [
          "11 The other street",
          "New Town",
          "YF9 3FP"
        ]
      },
      "resident": {
        "from": "2010-01-01",
        "to": "2011-11-11"
      }
    }
  ],
  "phones": [
    {
      "type": "HOME",
      "number": "+44 781 761 8573"
    }
  ]
}
{
  "title": "Mr",
  "firstName": "Dave",
  "middlenames": [
    "Dai"
  ],
  "lastnames": [
    "Jones"
  ],
  "gender": "MALE",
  "birthdate": "2000-01-01",
  "addresses": [
    {
      "address": {
        "premise": "18A",
        "building": "The House",
        "thoroughfare": "The Street",
        "locality": "The Town",
        "postalCode": "CL7 9DF",
        "country": "UK"
      },
      "resident": {
        "from": "2011-11-11"
      }
    }
  ],
  "phones": [
    {
      "type": "HOME",
      "number": "+44 781 761 8573"
    }
  ]
}
Response

The data provided was accepted and the verification results are returned

Response Headers
Name Type Description
verification-id string

The unique key for this verification transaction. This is the same as the verificationID field in the response.

customer-reference string

The same id as provided by the customer

Response Body
  • {
    • verificationID string Pattern: ^(\{{0,1}([0-9a-fA-F]){8}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){12}\}{0,1})$ example: 7ab2ff08-728a-42e6-aa38-df191ffd4817
    • timestamp string

      An ISO 8601 timestamp, with no optional bits:
      1) hyphens MUST be used to separate the date components
      2) day and month should be 2 digits
      3) colons MUST be used to separate the time components
      4) timestamps MUST NOT contain milliseconds
      5) timestamp MUST indicate the timezone, either as a time offset or a Zulu time indicator

      Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(([+-]\d{2}:\d{2})|Z)$ example: 2019-01-04T14:38:25
    • verificationURL string

      A URL to retrieve the full verification details

      example: https://api.gbgplc.com/people/{person-id}/verifications/{verification-id}
    • THIS IS A NULL VALUE
    • decision {
      • current string
      • combined string Enum: [REFER, PASS, UNDETERMINED] example: PASS
      }
    • action string

      Instruction on what a user needs to do next

      example: Upload next document
    }
{
  "verificationID": {
    "PrimitiveType": 4,
    "AnyType": 0,
    "Value": "7ab2ff08-728a-42e6-aa38-df191ffd4817"
  },
  "timestamp": {
    "PrimitiveType": 9,
    "AnyType": 0,
    "Value": "2019-01-04T14:38:25+00:00"
  },
  "verificationURL": {
    "PrimitiveType": 4,
    "AnyType": 0,
    "Value": "https://api.gbgplc.com/people/{person-id}/verifications/{verification-id}"
  },
  "person": null,
  "decision": {
    "current": {
      "Title": null,
      "Type": "string",
      "Format": null,
      "Description": null,
      "Maximum": null,
      "ExclusiveMaximum": null,
      "Minimum": null,
      "ExclusiveMinimum": null,
      "MaxLength": null,
      "MinLength": null,
      "Pattern": null,
      "MultipleOf": null,
      "Default": null,
      "ReadOnly": false,
      "WriteOnly": false,
      "AllOf": [],
      "OneOf": [],
      "AnyOf": [],
      "Not": null,
      "Required": [],
      "Items": null,
      "MaxItems": null,
      "MinItems": null,
      "UniqueItems": null,
      "Properties": {},
      "MaxProperties": null,
      "MinProperties": null,
      "AdditionalPropertiesAllowed": true,
      "AdditionalProperties": null,
      "Discriminator": null,
      "Example": null,
      "Enum": [],
      "Nullable": false,
      "ExternalDocs": null,
      "Deprecated": false,
      "Xml": null,
      "Extensions": {},
      "UnresolvedReference": false,
      "Reference": null
    },
    "combined": {
      "Title": null,
      "Type": "string",
      "Format": null,
      "Description": null,
      "Maximum": null,
      "ExclusiveMaximum": null,
      "Minimum": null,
      "ExclusiveMinimum": null,
      "MaxLength": null,
      "MinLength": null,
      "Pattern": null,
      "MultipleOf": null,
      "Default": null,
      "ReadOnly": false,
      "WriteOnly": false,
      "AllOf": [],
      "OneOf": [],
      "AnyOf": [],
      "Not": null,
      "Required": [],
      "Items": null,
      "MaxItems": null,
      "MinItems": null,
      "UniqueItems": null,
      "Properties": {},
      "MaxProperties": null,
      "MinProperties": null,
      "AdditionalPropertiesAllowed": true,
      "AdditionalProperties": null,
      "Discriminator": null,
      "Example": {
        "PrimitiveType": 4,
        "AnyType": 0,
        "Value": "PASS"
      },
      "Enum": [
        {
          "PrimitiveType": 4,
          "AnyType": 0,
          "Value": "REFER"
        },
        {
          "PrimitiveType": 4,
          "AnyType": 0,
          "Value": "PASS"
        },
        {
          "PrimitiveType": 4,
          "AnyType": 0,
          "Value": "UNDETERMINED"
        }
      ],
      "Nullable": false,
      "ExternalDocs": null,
      "Deprecated": false,
      "Xml": null,
      "Extensions": {},
      "UnresolvedReference": false,
      "Reference": null
    }
  },
  "action": {
    "PrimitiveType": 4,
    "AnyType": 0,
    "Value": "Upload next document"
  }
})

BadRequest

Response Body
  • {
    • CorrelationId string

      Unique id for this error. Enquiries to GBG should reference this.

      example: 7ab2ff08-728a-42e6-aa38-df191ffd4817
    • Errors [
      • Error {
        • Location string example: Authorization
        • Code integer example: 1106
        • Problem string example: The token is invalid
        • Action string example: Please pass a valid token for access
        }
      ]
    }
{
  "CorrelationId": {
    "PrimitiveType": 4,
    "AnyType": 0,
    "Value": "7ab2ff08-728a-42e6-aa38-df191ffd4817"
  },
  "Errors": {
    "Title": null,
    "Type": "object",
    "Format": null,
    "Description": null,
    "Maximum": null,
    "ExclusiveMaximum": null,
    "Minimum": null,
    "ExclusiveMinimum": null,
    "MaxLength": null,
    "MinLength": null,
    "Pattern": null,
    "MultipleOf": null,
    "Default": null,
    "ReadOnly": false,
    "WriteOnly": false,
    "AllOf": [],
    "OneOf": [],
    "AnyOf": [],
    "Not": null,
    "Required": [],
    "Items": null,
    "MaxItems": null,
    "MinItems": null,
    "UniqueItems": null,
    "Properties": {
      "Location": {
        "Title": null,
        "Type": "string",
        "Format": null,
        "Description": null,
        "Maximum": null,
        "ExclusiveMaximum": null,
        "Minimum": null,
        "ExclusiveMinimum": null,
        "MaxLength": null,
        "MinLength": null,
        "Pattern": null,
        "MultipleOf": null,
        "Default": null,
        "ReadOnly": false,
        "WriteOnly": false,
        "AllOf": [],
        "OneOf": [],
        "AnyOf": [],
        "Not": null,
        "Required": [],
        "Items": null,
        "MaxItems": null,
        "MinItems": null,
        "UniqueItems": null,
        "Properties": {},
        "MaxProperties": null,
        "MinProperties": null,
        "AdditionalPropertiesAllowed": true,
        "AdditionalProperties": null,
        "Discriminator": null,
        "Example": {
          "PrimitiveType": 4,
          "AnyType": 0,
          "Value": "Authorization"
        },
        "Enum": [],
        "Nullable": false,
        "ExternalDocs": null,
        "Deprecated": false,
        "Xml": null,
        "Extensions": {},
        "UnresolvedReference": false,
        "Reference": null
      },
      "Code": {
        "Title": null,
        "Type": "integer",
        "Format": null,
        "Description": null,
        "Maximum": null,
        "ExclusiveMaximum": null,
        "Minimum": null,
        "ExclusiveMinimum": null,
        "MaxLength": null,
        "MinLength": null,
        "Pattern": null,
        "MultipleOf": null,
        "Default": null,
        "ReadOnly": false,
        "WriteOnly": false,
        "AllOf": [],
        "OneOf": [],
        "AnyOf": [],
        "Not": null,
        "Required": [],
        "Items": null,
        "MaxItems": null,
        "MinItems": null,
        "UniqueItems": null,
        "Properties": {},
        "MaxProperties": null,
        "MinProperties": null,
        "AdditionalPropertiesAllowed": true,
        "AdditionalProperties": null,
        "Discriminator": null,
        "Example": {
          "PrimitiveType": 0,
          "AnyType": 0,
          "Value": 1106
        },
        "Enum": [],
        "Nullable": false,
        "ExternalDocs": null,
        "Deprecated": false,
        "Xml": null,
        "Extensions": {},
        "UnresolvedReference": false,
        "Reference": null
      },
      "Problem": {
        "Title": null,
        "Type": "string",
        "Format": null,
        "Description": null,
        "Maximum": null,
        "ExclusiveMaximum": null,
        "Minimum": null,
        "ExclusiveMinimum": null,
        "MaxLength": null,
        "MinLength": null,
        "Pattern": null,
        "MultipleOf": null,
        "Default": null,
        "ReadOnly": false,
        "WriteOnly": false,
        "AllOf": [],
        "OneOf": [],
        "AnyOf": [],
        "Not": null,
        "Required": [],
        "Items": null,
        "MaxItems": null,
        "MinItems": null,
        "UniqueItems": null,
        "Properties": {},
        "MaxProperties": null,
        "MinProperties": null,
        "AdditionalPropertiesAllowed": true,
        "AdditionalProperties": null,
        "Discriminator": null,
        "Example": {
          "PrimitiveType": 4,
          "AnyType": 0,
          "Value": "The token is invalid"
        },
        "Enum": [],
        "Nullable": false,
        "ExternalDocs": null,
        "Deprecated": false,
        "Xml": null,
        "Extensions": {},
        "UnresolvedReference": false,
        "Reference": null
      },
      "Action": {
        "Title": null,
        "Type": "string",
        "Format": null,
        "Description": null,
        "Maximum": null,
        "ExclusiveMaximum": null,
        "Minimum": null,
        "ExclusiveMinimum": null,
        "MaxLength": null,
        "MinLength": null,
        "Pattern": null,
        "MultipleOf": null,
        "Default": null,
        "ReadOnly": false,
        "WriteOnly": false,
        "AllOf": [],
        "OneOf": [],
        "AnyOf": [],
        "Not": null,
        "Required": [],
        "Items": null,
        "MaxItems": null,
        "MinItems": null,
        "UniqueItems": null,
        "Properties": {},
        "MaxProperties": null,
        "MinProperties": null,
        "AdditionalPropertiesAllowed": true,
        "AdditionalProperties": null,
        "Discriminator": null,
        "Example": {
          "PrimitiveType": 4,
          "AnyType": 0,
          "Value": "Please pass a valid token for access"
        },
        "Enum": [],
        "Nullable": false,
        "ExternalDocs": null,
        "Deprecated": false,
        "Xml": null,
        "Extensions": {},
        "UnresolvedReference": false,
        "Reference": null
      }
    },
    "MaxProperties": null,
    "MinProperties": null,
    "AdditionalPropertiesAllowed": true,
    "AdditionalProperties": null,
    "Discriminator": null,
    "Example": null,
    "Enum": [],
    "Nullable": false,
    "ExternalDocs": null,
    "Deprecated": false,
    "Xml": null,
    "Extensions": {},
    "UnresolvedReference": false,
    "Reference": null
  }
})

Unauthorized

Response Body
  • {
    • CorrelationId string

      Unique id for this error. Enquiries to GBG should reference this.

      example: 7ab2ff08-728a-42e6-aa38-df191ffd4817
    • Errors [
      • Error {
        • Location string example: Authorization
        • Code integer example: 1106
        • Problem string example: The token is invalid
        • Action string example: Please pass a valid token for access
        }
      ]
    }
{
  "CorrelationId": {
    "PrimitiveType": 4,
    "AnyType": 0,
    "Value": "7ab2ff08-728a-42e6-aa38-df191ffd4817"
  },
  "Errors": {
    "Title": null,
    "Type": "object",
    "Format": null,
    "Description": null,
    "Maximum": null,
    "ExclusiveMaximum": null,
    "Minimum": null,
    "ExclusiveMinimum": null,
    "MaxLength": null,
    "MinLength": null,
    "Pattern": null,
    "MultipleOf": null,
    "Default": null,
    "ReadOnly": false,
    "WriteOnly": false,
    "AllOf": [],
    "OneOf": [],
    "AnyOf": [],
    "Not": null,
    "Required": [],
    "Items": null,
    "MaxItems": null,
    "MinItems": null,
    "UniqueItems": null,
    "Properties": {
      "Location": {
        "Title": null,
        "Type": "string",
        "Format": null,
        "Description": null,
        "Maximum": null,
        "ExclusiveMaximum": null,
        "Minimum": null,
        "ExclusiveMinimum": null,
        "MaxLength": null,
        "MinLength": null,
        "Pattern": null,
        "MultipleOf": null,
        "Default": null,
        "ReadOnly": false,
        "WriteOnly": false,
        "AllOf": [],
        "OneOf": [],
        "AnyOf": [],
        "Not": null,
        "Required": [],
        "Items": null,
        "MaxItems": null,
        "MinItems": null,
        "UniqueItems": null,
        "Properties": {},
        "MaxProperties": null,
        "MinProperties": null,
        "AdditionalPropertiesAllowed": true,
        "AdditionalProperties": null,
        "Discriminator": null,
        "Example": {
          "PrimitiveType": 4,
          "AnyType": 0,
          "Value": "Authorization"
        },
        "Enum": [],
        "Nullable": false,
        "ExternalDocs": null,
        "Deprecated": false,
        "Xml": null,
        "Extensions": {},
        "UnresolvedReference": false,
        "Reference": null
      },
      "Code": {
        "Title": null,
        "Type": "integer",
        "Format": null,
        "Description": null,
        "Maximum": null,
        "ExclusiveMaximum": null,
        "Minimum": null,
        "ExclusiveMinimum": null,
        "MaxLength": null,
        "MinLength": null,
        "Pattern": null,
        "MultipleOf": null,
        "Default": null,
        "ReadOnly": false,
        "WriteOnly": false,
        "AllOf": [],
        "OneOf": [],
        "AnyOf": [],
        "Not": null,
        "Required": [],
        "Items": null,
        "MaxItems": null,
        "MinItems": null,
        "UniqueItems": null,
        "Properties": {},
        "MaxProperties": null,
        "MinProperties": null,
        "AdditionalPropertiesAllowed": true,
        "AdditionalProperties": null,
        "Discriminator": null,
        "Example": {
          "PrimitiveType": 0,
          "AnyType": 0,
          "Value": 1106
        },
        "Enum": [],
        "Nullable": false,
        "ExternalDocs": null,
        "Deprecated": false,
        "Xml": null,
        "Extensions": {},
        "UnresolvedReference": false,
        "Reference": null
      },
      "Problem": {
        "Title": null,
        "Type": "string",
        "Format": null,
        "Description": null,
        "Maximum": null,
        "ExclusiveMaximum": null,
        "Minimum": null,
        "ExclusiveMinimum": null,
        "MaxLength": null,
        "MinLength": null,
        "Pattern": null,
        "MultipleOf": null,
        "Default": null,
        "ReadOnly": false,
        "WriteOnly": false,
        "AllOf": [],
        "OneOf": [],
        "AnyOf": [],
        "Not": null,
        "Required": [],
        "Items": null,
        "MaxItems": null,
        "MinItems": null,
        "UniqueItems": null,
        "Properties": {},
        "MaxProperties": null,
        "MinProperties": null,
        "AdditionalPropertiesAllowed": true,
        "AdditionalProperties": null,
        "Discriminator": null,
        "Example": {
          "PrimitiveType": 4,
          "AnyType": 0,
          "Value": "The token is invalid"
        },
        "Enum": [],
        "Nullable": false,
        "ExternalDocs": null,
        "Deprecated": false,
        "Xml": null,
        "Extensions": {},
        "UnresolvedReference": false,
        "Reference": null
      },
      "Action": {
        "Title": null,
        "Type": "string",
        "Format": null,
        "Description": null,
        "Maximum": null,
        "ExclusiveMaximum": null,
        "Minimum": null,
        "ExclusiveMinimum": null,
        "MaxLength": null,
        "MinLength": null,
        "Pattern": null,
        "MultipleOf": null,
        "Default": null,
        "ReadOnly": false,
        "WriteOnly": false,
        "AllOf": [],
        "OneOf": [],
        "AnyOf": [],
        "Not": null,
        "Required": [],
        "Items": null,
        "MaxItems": null,
        "MinItems": null,
        "UniqueItems": null,
        "Properties": {},
        "MaxProperties": null,
        "MinProperties": null,
        "AdditionalPropertiesAllowed": true,
        "AdditionalProperties": null,
        "Discriminator": null,
        "Example": {
          "PrimitiveType": 4,
          "AnyType": 0,
          "Value": "Please pass a valid token for access"
        },
        "Enum": [],
        "Nullable": false,
        "ExternalDocs": null,
        "Deprecated": false,
        "Xml": null,
        "Extensions": {},
        "UnresolvedReference": false,
        "Reference": null
      }
    },
    "MaxProperties": null,
    "MinProperties": null,
    "AdditionalPropertiesAllowed": true,
    "AdditionalProperties": null,
    "Discriminator": null,
    "Example": null,
    "Enum": [],
    "Nullable": false,
    "ExternalDocs": null,
    "Deprecated": false,
    "Xml": null,
    "Extensions": {},
    "UnresolvedReference": false,
    "Reference": null
  }
})

Forbidden

Response Body
  • {
    • CorrelationId string

      Unique id for this error. Enquiries to GBG should reference this.

      example: 7ab2ff08-728a-42e6-aa38-df191ffd4817
    • Errors [
      • Error {
        • Location string example: Authorization
        • Code integer example: 1106
        • Problem string example: The token is invalid
        • Action string example: Please pass a valid token for access
        }
      ]
    }
{
  "CorrelationId": {
    "PrimitiveType": 4,
    "AnyType": 0,
    "Value": "7ab2ff08-728a-42e6-aa38-df191ffd4817"
  },
  "Errors": {
    "Title": null,
    "Type": "object",
    "Format": null,
    "Description": null,
    "Maximum": null,
    "ExclusiveMaximum": null,
    "Minimum": null,
    "ExclusiveMinimum": null,
    "MaxLength": null,
    "MinLength": null,
    "Pattern": null,
    "MultipleOf": null,
    "Default": null,
    "ReadOnly": false,
    "WriteOnly": false,
    "AllOf": [],
    "OneOf": [],
    "AnyOf": [],
    "Not": null,
    "Required": [],
    "Items": null,
    "MaxItems": null,
    "MinItems": null,
    "UniqueItems": null,
    "Properties": {
      "Location": {
        "Title": null,
        "Type": "string",
        "Format": null,
        "Description": null,
        "Maximum": null,
        "ExclusiveMaximum": null,
        "Minimum": null,
        "ExclusiveMinimum": null,
        "MaxLength": null,
        "MinLength": null,
        "Pattern": null,
        "MultipleOf": null,
        "Default": null,
        "ReadOnly": false,
        "WriteOnly": false,
        "AllOf": [],
        "OneOf": [],
        "AnyOf": [],
        "Not": null,
        "Required": [],
        "Items": null,
        "MaxItems": null,
        "MinItems": null,
        "UniqueItems": null,
        "Properties": {},
        "MaxProperties": null,
        "MinProperties": null,
        "AdditionalPropertiesAllowed": true,
        "AdditionalProperties": null,
        "Discriminator": null,
        "Example": {
          "PrimitiveType": 4,
          "AnyType": 0,
          "Value": "Authorization"
        },
        "Enum": [],
        "Nullable": false,
        "ExternalDocs": null,
        "Deprecated": false,
        "Xml": null,
        "Extensions": {},
        "UnresolvedReference": false,
        "Reference": null
      },
      "Code": {
        "Title": null,
        "Type": "integer",
        "Format": null,
        "Description": null,
        "Maximum": null,
        "ExclusiveMaximum": null,
        "Minimum": null,
        "ExclusiveMinimum": null,
        "MaxLength": null,
        "MinLength": null,
        "Pattern": null,
        "MultipleOf": null,
        "Default": null,
        "ReadOnly": false,
        "WriteOnly": false,
        "AllOf": [],
        "OneOf": [],
        "AnyOf": [],
        "Not": null,
        "Required": [],
        "Items": null,
        "MaxItems": null,
        "MinItems": null,
        "UniqueItems": null,
        "Properties": {},
        "MaxProperties": null,
        "MinProperties": null,
        "AdditionalPropertiesAllowed": true,
        "AdditionalProperties": null,
        "Discriminator": null,
        "Example": {
          "PrimitiveType": 0,
          "AnyType": 0,
          "Value": 1106
        },
        "Enum": [],
        "Nullable": false,
        "ExternalDocs": null,
        "Deprecated": false,
        "Xml": null,
        "Extensions": {},
        "UnresolvedReference": false,
        "Reference": null
      },
      "Problem": {
        "Title": null,
        "Type": "string",
        "Format": null,
        "Description": null,
        "Maximum": null,
        "ExclusiveMaximum": null,
        "Minimum": null,
        "ExclusiveMinimum": null,
        "MaxLength": null,
        "MinLength": null,
        "Pattern": null,
        "MultipleOf": null,
        "Default": null,
        "ReadOnly": false,
        "WriteOnly": false,
        "AllOf": [],
        "OneOf": [],
        "AnyOf": [],
        "Not": null,
        "Required": [],
        "Items": null,
        "MaxItems": null,
        "MinItems": null,
        "UniqueItems": null,
        "Properties": {},
        "MaxProperties": null,
        "MinProperties": null,
        "AdditionalPropertiesAllowed": true,
        "AdditionalProperties": null,
        "Discriminator": null,
        "Example": {
          "PrimitiveType": 4,
          "AnyType": 0,
          "Value": "The token is invalid"
        },
        "Enum": [],
        "Nullable": false,
        "ExternalDocs": null,
        "Deprecated": false,
        "Xml": null,
        "Extensions": {},
        "UnresolvedReference": false,
        "Reference": null
      },
      "Action": {
        "Title": null,
        "Type": "string",
        "Format": null,
        "Description": null,
        "Maximum": null,
        "ExclusiveMaximum": null,
        "Minimum": null,
        "ExclusiveMinimum": null,
        "MaxLength": null,
        "MinLength": null,
        "Pattern": null,
        "MultipleOf": null,
        "Default": null,
        "ReadOnly": false,
        "WriteOnly": false,
        "AllOf": [],
        "OneOf": [],
        "AnyOf": [],
        "Not": null,
        "Required": [],
        "Items": null,
        "MaxItems": null,
        "MinItems": null,
        "UniqueItems": null,
        "Properties": {},
        "MaxProperties": null,
        "MinProperties": null,
        "AdditionalPropertiesAllowed": true,
        "AdditionalProperties": null,
        "Discriminator": null,
        "Example": {
          "PrimitiveType": 4,
          "AnyType": 0,
          "Value": "Please pass a valid token for access"
        },
        "Enum": [],
        "Nullable": false,
        "ExternalDocs": null,
        "Deprecated": false,
        "Xml": null,
        "Extensions": {},
        "UnresolvedReference": false,
        "Reference": null
      }
    },
    "MaxProperties": null,
    "MinProperties": null,
    "AdditionalPropertiesAllowed": true,
    "AdditionalProperties": null,
    "Discriminator": null,
    "Example": null,
    "Enum": [],
    "Nullable": false,
    "ExternalDocs": null,
    "Deprecated": false,
    "Xml": null,
    "Extensions": {},
    "UnresolvedReference": false,
    "Reference": null
  }
})

UnsupportedMediaType

Response Body
  • {
    • CorrelationId string

      Unique id for this error. Enquiries to GBG should reference this.

      example: 7ab2ff08-728a-42e6-aa38-df191ffd4817
    • Errors [
      • Error {
        • Location string example: Authorization
        • Code integer example: 1106
        • Problem string example: The token is invalid
        • Action string example: Please pass a valid token for access
        }
      ]
    }
{
  "CorrelationId": {
    "PrimitiveType": 4,
    "AnyType": 0,
    "Value": "7ab2ff08-728a-42e6-aa38-df191ffd4817"
  },
  "Errors": {
    "Title": null,
    "Type": "object",
    "Format": null,
    "Description": null,
    "Maximum": null,
    "ExclusiveMaximum": null,
    "Minimum": null,
    "ExclusiveMinimum": null,
    "MaxLength": null,
    "MinLength": null,
    "Pattern": null,
    "MultipleOf": null,
    "Default": null,
    "ReadOnly": false,
    "WriteOnly": false,
    "AllOf": [],
    "OneOf": [],
    "AnyOf": [],
    "Not": null,
    "Required": [],
    "Items": null,
    "MaxItems": null,
    "MinItems": null,
    "UniqueItems": null,
    "Properties": {
      "Location": {
        "Title": null,
        "Type": "string",
        "Format": null,
        "Description": null,
        "Maximum": null,
        "ExclusiveMaximum": null,
        "Minimum": null,
        "ExclusiveMinimum": null,
        "MaxLength": null,
        "MinLength": null,
        "Pattern": null,
        "MultipleOf": null,
        "Default": null,
        "ReadOnly": false,
        "WriteOnly": false,
        "AllOf": [],
        "OneOf": [],
        "AnyOf": [],
        "Not": null,
        "Required": [],
        "Items": null,
        "MaxItems": null,
        "MinItems": null,
        "UniqueItems": null,
        "Properties": {},
        "MaxProperties": null,
        "MinProperties": null,
        "AdditionalPropertiesAllowed": true,
        "AdditionalProperties": null,
        "Discriminator": null,
        "Example": {
          "PrimitiveType": 4,
          "AnyType": 0,
          "Value": "Authorization"
        },
        "Enum": [],
        "Nullable": false,
        "ExternalDocs": null,
        "Deprecated": false,
        "Xml": null,
        "Extensions": {},
        "UnresolvedReference": false,
        "Reference": null
      },
      "Code": {
        "Title": null,
        "Type": "integer",
        "Format": null,
        "Description": null,
        "Maximum": null,
        "ExclusiveMaximum": null,
        "Minimum": null,
        "ExclusiveMinimum": null,
        "MaxLength": null,
        "MinLength": null,
        "Pattern": null,
        "MultipleOf": null,
        "Default": null,
        "ReadOnly": false,
        "WriteOnly": false,
        "AllOf": [],
        "OneOf": [],
        "AnyOf": [],
        "Not": null,
        "Required": [],
        "Items": null,
        "MaxItems": null,
        "MinItems": null,
        "UniqueItems": null,
        "Properties": {},
        "MaxProperties": null,
        "MinProperties": null,
        "AdditionalPropertiesAllowed": true,
        "AdditionalProperties": null,
        "Discriminator": null,
        "Example": {
          "PrimitiveType": 0,
          "AnyType": 0,
          "Value": 1106
        },
        "Enum": [],
        "Nullable": false,
        "ExternalDocs": null,
        "Deprecated": false,
        "Xml": null,
        "Extensions": {},
        "UnresolvedReference": false,
        "Reference": null
      },
      "Problem": {
        "Title": null,
        "Type": "string",
        "Format": null,
        "Description": null,
        "Maximum": null,
        "ExclusiveMaximum": null,
        "Minimum": null,
        "ExclusiveMinimum": null,
        "MaxLength": null,
        "MinLength": null,
        "Pattern": null,
        "MultipleOf": null,
        "Default": null,
        "ReadOnly": false,
        "WriteOnly": false,
        "AllOf": [],
        "OneOf": [],
        "AnyOf": [],
        "Not": null,
        "Required": [],
        "Items": null,
        "MaxItems": null,
        "MinItems": null,
        "UniqueItems": null,
        "Properties": {},
        "MaxProperties": null,
        "MinProperties": null,
        "AdditionalPropertiesAllowed": true,
        "AdditionalProperties": null,
        "Discriminator": null,
        "Example": {
          "PrimitiveType": 4,
          "AnyType": 0,
          "Value": "The token is invalid"
        },
        "Enum": [],
        "Nullable": false,
        "ExternalDocs": null,
        "Deprecated": false,
        "Xml": null,
        "Extensions": {},
        "UnresolvedReference": false,
        "Reference": null
      },
      "Action": {
        "Title": null,
        "Type": "string",
        "Format": null,
        "Description": null,
        "Maximum": null,
        "ExclusiveMaximum": null,
        "Minimum": null,
        "ExclusiveMinimum": null,
        "MaxLength": null,
        "MinLength": null,
        "Pattern": null,
        "MultipleOf": null,
        "Default": null,
        "ReadOnly": false,
        "WriteOnly": false,
        "AllOf": [],
        "OneOf": [],
        "AnyOf": [],
        "Not": null,
        "Required": [],
        "Items": null,
        "MaxItems": null,
        "MinItems": null,
        "UniqueItems": null,
        "Properties": {},
        "MaxProperties": null,
        "MinProperties": null,
        "AdditionalPropertiesAllowed": true,
        "AdditionalProperties": null,
        "Discriminator": null,
        "Example": {
          "PrimitiveType": 4,
          "AnyType": 0,
          "Value": "Please pass a valid token for access"
        },
        "Enum": [],
        "Nullable": false,
        "ExternalDocs": null,
        "Deprecated": false,
        "Xml": null,
        "Extensions": {},
        "UnresolvedReference": false,
        "Reference": null
      }
    },
    "MaxProperties": null,
    "MinProperties": null,
    "AdditionalPropertiesAllowed": true,
    "AdditionalProperties": null,
    "Discriminator": null,
    "Example": null,
    "Enum": [],
    "Nullable": false,
    "ExternalDocs": null,
    "Deprecated": false,
    "Xml": null,
    "Extensions": {},
    "UnresolvedReference": false,
    "Reference": null
  }
})

Internal Server Error

Response Body
  • {
    • CorrelationId string

      Unique id for this error. Enquiries to GBG should reference this.

      example: 7ab2ff08-728a-42e6-aa38-df191ffd4817
    • Errors [
      • Error {
        • Location string example: Authorization
        • Code integer example: 1106
        • Problem string example: The token is invalid
        • Action string example: Please pass a valid token for access
        }
      ]
    }
{
  "CorrelationId": {
    "PrimitiveType": 4,
    "AnyType": 0,
    "Value": "7ab2ff08-728a-42e6-aa38-df191ffd4817"
  },
  "Errors": {
    "Title": null,
    "Type": "object",
    "Format": null,
    "Description": null,
    "Maximum": null,
    "ExclusiveMaximum": null,
    "Minimum": null,
    "ExclusiveMinimum": null,
    "MaxLength": null,
    "MinLength": null,
    "Pattern": null,
    "MultipleOf": null,
    "Default": null,
    "ReadOnly": false,
    "WriteOnly": false,
    "AllOf": [],
    "OneOf": [],
    "AnyOf": [],
    "Not": null,
    "Required": [],
    "Items": null,
    "MaxItems": null,
    "MinItems": null,
    "UniqueItems": null,
    "Properties": {
      "Location": {
        "Title": null,
        "Type": "string",
        "Format": null,
        "Description": null,
        "Maximum": null,
        "ExclusiveMaximum": null,
        "Minimum": null,
        "ExclusiveMinimum": null,
        "MaxLength": null,
        "MinLength": null,
        "Pattern": null,
        "MultipleOf": null,
        "Default": null,
        "ReadOnly": false,
        "WriteOnly": false,
        "AllOf": [],
        "OneOf": [],
        "AnyOf": [],
        "Not": null,
        "Required": [],
        "Items": null,
        "MaxItems": null,
        "MinItems": null,
        "UniqueItems": null,
        "Properties": {},
        "MaxProperties": null,
        "MinProperties": null,
        "AdditionalPropertiesAllowed": true,
        "AdditionalProperties": null,
        "Discriminator": null,
        "Example": {
          "PrimitiveType": 4,
          "AnyType": 0,
          "Value": "Authorization"
        },
        "Enum": [],
        "Nullable": false,
        "ExternalDocs": null,
        "Deprecated": false,
        "Xml": null,
        "Extensions": {},
        "UnresolvedReference": false,
        "Reference": null
      },
      "Code": {
        "Title": null,
        "Type": "integer",
        "Format": null,
        "Description": null,
        "Maximum": null,
        "ExclusiveMaximum": null,
        "Minimum": null,
        "ExclusiveMinimum": null,
        "MaxLength": null,
        "MinLength": null,
        "Pattern": null,
        "MultipleOf": null,
        "Default": null,
        "ReadOnly": false,
        "WriteOnly": false,
        "AllOf": [],
        "OneOf": [],
        "AnyOf": [],
        "Not": null,
        "Required": [],
        "Items": null,
        "MaxItems": null,
        "MinItems": null,
        "UniqueItems": null,
        "Properties": {},
        "MaxProperties": null,
        "MinProperties": null,
        "AdditionalPropertiesAllowed": true,
        "AdditionalProperties": null,
        "Discriminator": null,
        "Example": {
          "PrimitiveType": 0,
          "AnyType": 0,
          "Value": 1106
        },
        "Enum": [],
        "Nullable": false,
        "ExternalDocs": null,
        "Deprecated": false,
        "Xml": null,
        "Extensions": {},
        "UnresolvedReference": false,
        "Reference": null
      },
      "Problem": {
        "Title": null,
        "Type": "string",
        "Format": null,
        "Description": null,
        "Maximum": null,
        "ExclusiveMaximum": null,
        "Minimum": null,
        "ExclusiveMinimum": null,
        "MaxLength": null,
        "MinLength": null,
        "Pattern": null,
        "MultipleOf": null,
        "Default": null,
        "ReadOnly": false,
        "WriteOnly": false,
        "AllOf": [],
        "OneOf": [],
        "AnyOf": [],
        "Not": null,
        "Required": [],
        "Items": null,
        "MaxItems": null,
        "MinItems": null,
        "UniqueItems": null,
        "Properties": {},
        "MaxProperties": null,
        "MinProperties": null,
        "AdditionalPropertiesAllowed": true,
        "AdditionalProperties": null,
        "Discriminator": null,
        "Example": {
          "PrimitiveType": 4,
          "AnyType": 0,
          "Value": "The token is invalid"
        },
        "Enum": [],
        "Nullable": false,
        "ExternalDocs": null,
        "Deprecated": false,
        "Xml": null,
        "Extensions": {},
        "UnresolvedReference": false,
        "Reference": null
      },
      "Action": {
        "Title": null,
        "Type": "string",
        "Format": null,
        "Description": null,
        "Maximum": null,
        "ExclusiveMaximum": null,
        "Minimum": null,
        "ExclusiveMinimum": null,
        "MaxLength": null,
        "MinLength": null,
        "Pattern": null,
        "MultipleOf": null,
        "Default": null,
        "ReadOnly": false,
        "WriteOnly": false,
        "AllOf": [],
        "OneOf": [],
        "AnyOf": [],
        "Not": null,
        "Required": [],
        "Items": null,
        "MaxItems": null,
        "MinItems": null,
        "UniqueItems": null,
        "Properties": {},
        "MaxProperties": null,
        "MinProperties": null,
        "AdditionalPropertiesAllowed": true,
        "AdditionalProperties": null,
        "Discriminator": null,
        "Example": {
          "PrimitiveType": 4,
          "AnyType": 0,
          "Value": "Please pass a valid token for access"
        },
        "Enum": [],
        "Nullable": false,
        "ExternalDocs": null,
        "Deprecated": false,
        "Xml": null,
        "Extensions": {},
        "UnresolvedReference": false,
        "Reference": null
      }
    },
    "MaxProperties": null,
    "MinProperties": null,
    "AdditionalPropertiesAllowed": true,
    "AdditionalProperties": null,
    "Discriminator": null,
    "Example": null,
    "Enum": [],
    "Nullable": false,
    "ExternalDocs": null,
    "Deprecated": false,
    "Xml": null,
    "Extensions": {},
    "UnresolvedReference": false,
    "Reference": null
  }
})
  • cURL
  • JavaScript
  • C#
  • PHP
  • Java (Spring)
curl -X POST \
 - H 'Authorization: Bearer {Authorization}' \
 - H 'cleanse-address: true' \
 - H 'journey-id: 9d75d85e-f7bc-4d22-a93b-60c04881193d' \
 - H 'journey-version: 1' \
 - H 'customer-reference: 9d75d86e-f7bc-4d22-a93b-59c04881193f' \
 - H 'triangulation-verification-id: 9d75d85e-f7bc-4d22-a93b-60c04881193d' \
 - H 'Content-Type: application/json' \
    -d '{
  "title": "Mr",
  "firstName": "Dave",
  "middlenames": [
    "Dai"
  ],
  "lastnames": [
    "Jones"
  ],
  "gender": "MALE",
  "birthdate": "2000-01-01",
  "addresses": [
    {
      "type": "CURRENT",
      "address": {
        "premise": "18A",
        "building": "The House",
        "thoroughfare": "The Street",
        "locality": "The Town",
        "postalCode": "CL7 9DF",
        "country": "UK"
      },
      "resident": {
        "from": "2011-11-11"
      }
    },
    {
      "type": "PREVIOUS",
      "address": {
        "lines": [
          "11 The other street",
          "New Town",
          "YF9 3FP"
        ]
      },
      "resident": {
        "from": "2010-01-01",
        "to": "2011-11-11"
      }
    }
  ],
  "phones": [
    {
      "type": "HOME",
      "number": "+44 781 761 8573"
    }
  ]
}' \
"https://api.gbgplc.com/verify/people/v4/{person-id}"
var data = JSON.stringify({
  "title": "Mr",
  "firstName": "Dave",
  "middlenames": [
    "Dai"
  ],
  "lastnames": [
    "Jones"
  ],
  "gender": "MALE",
  "birthdate": "2000-01-01",
  "addresses": [
    {
      "type": "CURRENT",
      "address": {
        "premise": "18A",
        "building": "The House",
        "thoroughfare": "The Street",
        "locality": "The Town",
        "postalCode": "CL7 9DF",
        "country": "UK"
      },
      "resident": {
        "from": "2011-11-11"
      }
    },
    {
      "type": "PREVIOUS",
      "address": {
        "lines": [
          "11 The other street",
          "New Town",
          "YF9 3FP"
        ]
      },
      "resident": {
        "from": "2010-01-01",
        "to": "2011-11-11"
      }
    }
  ],
  "phones": [
    {
      "type": "HOME",
      "number": "+44 781 761 8573"
    }
  ]
});
var xhr = new XMLHttpRequest();
xhr.addEventListener('readystatechange', function () {
    if (this.readyState === this.DONE) {
        console.log(this.responseText);
    }
});
xhr.open('Post', 'https://api.gbgplc.com/verify/people/v4/{person-id}');
xhr.setRequestHeader('Authorization', 'Bearer {Authorization}');
xhr.setRequestHeader('cleanse-address', 'true');
xhr.setRequestHeader('journey-id', '9d75d85e-f7bc-4d22-a93b-60c04881193d');
xhr.setRequestHeader('journey-version', '1');
xhr.setRequestHeader('customer-reference', '9d75d86e-f7bc-4d22-a93b-59c04881193f');
xhr.setRequestHeader('triangulation-verification-id', '9d75d85e-f7bc-4d22-a93b-60c04881193d');
xhr.setRequestHeader('Content-Type', 'application/json');
xhr.send(data);
var client = new HttpClient();
var message = new HttpRequestMessage(HttpMethod.Post, "https://api.gbgplc.com/verify/people/v4/{person-id}");
message.Headers.Add("Authorization", "Bearer {Authorization}");
message.Headers.Add("cleanse-address", "true");
message.Headers.Add("journey-id", "9d75d85e-f7bc-4d22-a93b-60c04881193d");
message.Headers.Add("journey-version", "1");
message.Headers.Add("customer-reference", "9d75d86e-f7bc-4d22-a93b-59c04881193f");
message.Headers.Add("triangulation-verification-id", "9d75d85e-f7bc-4d22-a93b-60c04881193d");
message.Content = new StringContent(@"{
  ""title"": ""Mr"",
  ""firstName"": ""Dave"",
  ""middlenames"": [
    ""Dai""
  ],
  ""lastnames"": [
    ""Jones""
  ],
  ""gender"": ""MALE"",
  ""birthdate"": ""2000-01-01"",
  ""addresses"": [
    {
      ""type"": ""CURRENT"",
      ""address"": {
        ""premise"": ""18A"",
        ""building"": ""The House"",
        ""thoroughfare"": ""The Street"",
        ""locality"": ""The Town"",
        ""postalCode"": ""CL7 9DF"",
        ""country"": ""UK""
      },
      ""resident"": {
        ""from"": ""2011-11-11""
      }
    },
    {
      ""type"": ""PREVIOUS"",
      ""address"": {
        ""lines"": [
          ""11 The other street"",
          ""New Town"",
          ""YF9 3FP""
        ]
      },
      ""resident"": {
        ""from"": ""2010-01-01"",
        ""to"": ""2011-11-11""
      }
    }
  ],
  ""phones"": [
    {
      ""type"": ""HOME"",
      ""number"": ""+44 781 761 8573""
    }
  ]
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(message);
var responseString = await response.Content.ReadAsStringAsync();
Console.WriteLine(responseString);
$url = 'https://api.gbgplc.com/verify/people/v4/{person-id}';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
$data = '{
  "title": "Mr",
  "firstName": "Dave",
  "middlenames": [
    "Dai"
  ],
  "lastnames": [
    "Jones"
  ],
  "gender": "MALE",
  "birthdate": "2000-01-01",
  "addresses": [
    {
      "type": "CURRENT",
      "address": {
        "premise": "18A",
        "building": "The House",
        "thoroughfare": "The Street",
        "locality": "The Town",
        "postalCode": "CL7 9DF",
        "country": "UK"
      },
      "resident": {
        "from": "2011-11-11"
      }
    },
    {
      "type": "PREVIOUS",
      "address": {
        "lines": [
          "11 The other street",
          "New Town",
          "YF9 3FP"
        ]
      },
      "resident": {
        "from": "2010-01-01",
        "to": "2011-11-11"
      }
    }
  ],
  "phones": [
    {
      "type": "HOME",
      "number": "+44 781 761 8573"
    }
  ]
}';
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(     
    'Authorization: Bearer {Authorization}',
    'cleanse-address: true',
    'journey-id: 9d75d85e-f7bc-4d22-a93b-60c04881193d',
    'journey-version: 1',
    'customer-reference: 9d75d86e-f7bc-4d22-a93b-59c04881193f',
    'triangulation-verification-id: 9d75d85e-f7bc-4d22-a93b-60c04881193d',
    'content-type: application/json',
    'Content-Length: ' . strlen($data))
);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
$json = json_decode($response, true);
curl_close($ch);
print_r($json);
HttpHeaders headers = new HttpHeaders();
headers.set("Authorization", "Bearer {Authorization}");
headers.set("cleanse-address", "true");
headers.set("journey-id", "9d75d85e-f7bc-4d22-a93b-60c04881193d");
headers.set("journey-version", "1");
headers.set("customer-reference", "9d75d86e-f7bc-4d22-a93b-59c04881193f");
headers.set("triangulation-verification-id", "9d75d85e-f7bc-4d22-a93b-60c04881193d");
String body = "<JSON BODY>";
HttpEntity<String> request = new HttpEntity<>(body, headers);
String host = "https://api.gbgplc.com/verify/people/v4/{person-id}";
//restTemplate should be autowired via constructor of this class
ResponseEntity<String> response = restTemplate.postForEntity(host, request, String.class);
if (200 == response.getStatusCodeValue()){
    //DO STUFF
}

Remember! Each of the marked variables should be replaced with your credentials or your chosen options.