Create claimant

This endpoint is used to add a claimant to an incident.

post
https://api.claimsmanagertest.crawco.co.uk/incidents/{incidentId}/claimants

Path parameters

Parameters marked are required.
Parameter Name Description Type Example Data
incidentId The incident id of the incident to which the claimant should be added. Integer 6597925

Request body parameters

Parameters marked are required.
Parameter Name Description Type Example Data
firstName The first name of the claimant. string John
lastName The last name of the claimant. string Smith
organisationName The organisation name where the claimant is not an individual. string
isOrganisation Flag specifying whether the claimant is an individual or an organisation. Boolean False
dateOfBirth The date of birth of the claimant. string ($date) 1967-07-12
gender The gender of the claimant. string Male
claimantType The type of claimant to add. string
contactPerson The name of the contact person for the claimant. string Mr. John Smith
contactAddress The contact address of the claimant. string 15 Knights Park Kingston Upon Thames Surrey
contactPostalCode The post code of the claimant. string KT1 2AA
contactTelephoneNumber The telephone number of the claimant. string 0208 541 1111
contactMobileNumber The mobile telephone number of the claimant string 07940012345
contactEmailAddress The email address of the claimant. string($email) john.smith@email.com
extendedFields An array containing any extended fields array See Extended Fields

When isOrganisation is false, the firstName and lastName fields are required. When isOrganisation is true then the organisationName field is required.

Example request

curl --location --request POST 'https://api.claimsmanagertest.crawco.co.uk/incidents/6597925/Claimants' \
--header 'Authorization: Bearer {access token}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "firstName": "John",
  "lastName": "Smith",
  "isOrganisation": false,
  "dateOfBirth": "1976-07-10",
  "gender": "Male",
  "contactPerson": "Mr. John Smith",
  "contactAddress": "15 Knights Park\r\nKingston Upon Thames\r\nSurrey",
  "contactPostalCode": "KT1 2AA",
  "contactTelephoneNumber": "0208 541 1111",
  "contactMobileNumber": "07940012345",
  "contactEmailAddress": "john.smith@email.com",
  "extendedFields": [
    {
      "identifier": "Global_Claimant_Form:Title",
      "value": "Mr"
    },
    {
      "identifier": "Global_Claimant_Form:Policy_Reference",
      "value": "POL1234567Z"
    },
    {
      "identifier": "Global_Claimant_Form:Policy_StartDate",
      "value": "2020-10-01"
    },
    {
      "identifier": "Global_Claimant_Form:Policy_EndDate",
      "value": "2021-09-30"
    }
  ]
}'

Response body parameters

Parameters marked are required.
Parameter Name Description Type Example Data
claimantId The claimant id of the newly created claimant. Integer 50000

Example response

736716