Skip to main content

Claims

Claims are unverified data points or pieces of information attached to a legal person. They describe alleged facts about an entity, ranging from common data points like names or addresses to specific ones like the purpose for wanting an account with us.

About claims​

They are attached to legal persons: Claims belong to legal persons, which can be individuals or corporations.

Collected during onboarding: Claims are always collected at the point of onboarding a legal person, as they are used in verifications which form our customer due diligence requirements.

Must be kept up to date: When information on a customer or applicant changes, it must be updated in our system. These are used in ongoing screening, monitoring activities, and periodic reviews of customers.

Verified and unverified: A verified claim has been used in an accepted verification. An unverified claim is when a verification hasn’t been run on a claim, or a verification resulted in a declined or errored decision.

Request​

{
curl "https://api.griffin.com/v0/legal-persons/lp.XAFUuT2TS56XCyfKBgXQXg/claims" \
-H "Authorization: GriffinAPIKey $GRIFFIN_API_KEY" \ 
-H 'Content-Type: application/json' \
-d '{ "claim-type": "uk-company-register",
      "entity-name": "Money Technology Ltd",
      "corporation-type": "private-limited-company",
      "entity-registration-number": "91824539",
      "date-of-incorporation": "2017-06-01",
      "building-number": "184",
      "city": "London",
      "street-name": "Argyle Street",
      "postal-code": "EC2V 9AN",      
      "country-code": "GB" }'
},

Response​

{
  "postal-code": "EC2V 9AN",
  "claim-url": "/v0/claims/cl.3xaUlv7ZXW2_bDid6vLh4Q",
  "corporation-type": "private-limited-company",
  "street-name": "Argyle Street",
  "entity-name": "Money Technology Ltd",
  "entity-registration-number": "91824539",
  "created-at": "2025-11-10T12:51:11.789Z",
  "date-of-incorporation": "2017-06-01",
  "claim-type": "uk-company-register",
  "building-number": "184",
  "city": "London",
  "country-code": "GB"
}

Claims are immutable.​

To update a claim, create a new claim with the updated data. The updated claim will be used in future verifications.

Request​

{
curl "https://api.griffin.com/v0/legal-persons/lp.XAFUuT2TS56XCyfKBgXQXg/claims" \ 
-H "Authorization: GriffinAPIKey $GRIFFIN_API_KEY"
},

Response​

{
  "claims": [
    {
      "postal-code": "EC2V 9AN",
      "claim-url": "/v0/claims/cl.3xaUlv7ZXW2_bDid6vLh4Q",
      "corporation-type": "private-limited-company",
      "street-name": "Argyle Street",
      "entity-name": "Money Technology Ltd",
      "entity-registration-number": "91824539",
      "created-at": "2025-11-10T12:51:11.789Z",
      "date-of-incorporation": "2017-06-01",
      "claim-type": "uk-company-register",
      "building-number": "184",
      "city": "London",
      "country-code": "GB"
    }
  ],
  "links": {
    "prev": null,
    "next": null
  },
  "meta": {
    "page": {
      "total": 1
    }
  }
}

The claim URL in this response can be used to delete associations between companies and directors/PSCs.

Once you've created a legal person, and associated claims to the legal person record you will need to run a verification. Check out our guides for onboarding customers.