Creates a discrepancy for a PSC Discrepancy Report

Request

POST https://api.company-information.service.gov.uk/psc-discrepancy-reports/{discrepancy-report-id}/discrepancies

Path parameters

Parameter name Value Description Additional
discrepancy-report-id string

ID of PSC Discrepancy Report

Required

Request body

The request body takes a complete Discrepancy resource, containing the following writable properties:

{
    "details": "string",
    "psc_date_of_birth": "MM/YYYY",
    "psc_discrepancy_types": [
        "string"
    ],
    "psc_name": "string",
    "psc_type": "string"
}

Properties

Name Type Description Additional
details string
psc_date_of_birth MM/YYYY

The psc_date_of_birth is only mandatory when the psc_type is individual-person-with-significant-control

psc_discrepancy_types[] array of string

Possible values are:

  • Nature of control
  • Correspondence address
  • Notified date
  • Other reason
  • Name
  • Date of birth
  • Nationality
  • Country of residence
  • Company name
  • Governing law
  • Legal form
  • Company number
  • Place of registration
  • Incorporation law
psc_name string

The psc_name is not mandatory if the psc_type is psc-is-missing

psc_type string

Possible values are:

  • individual-person-with-significant-control
  • corporate-entity-person-with-significant-control
  • legal-person-person-with-significant-control
  • psc-is-missing

Response

The following HTTP status codes may be returned, optionally with a response resource.

Status code Description Resource
201 Created

Discrepancy created

DiscrepancyResponse
400 Bad Request

The body has errors. The correct error is displayed if a single element is omitted from the call but if multiple elements are left out not all errors are displayed. Eg if only the status is added to the body of a /psc-discrepancy-reports POST the only error that fires is for the obliged-entity type and not the other 4 fields that are missing.

Error
404 Not Found

Not found

500 Internal Server Error

Internal Server Error