GRgriffin
Legal persons

Create legal person

Changed on

Creates a new Legal Person. A collection of Claims may be provided.

post/v0/organizations/{organization-id}/legal-persons

Request

Path parameters

organization-idstring required

Request body

display-namestring required

A human readable label for an entity

legal-person-type'individual' | 'corporation' required

Specifies if the legal person is an individual or a corporation.

Example request

{
  "claims": [
    {
      "telephone-number": "+442012345678"
    }
  ]
}

Response

Created

legal-person-type'individual' | 'corporation' required

Specifies if the legal person is an individual or a corporation.

latest-risk-rating-urlstring

A contextual link to the risk rating.

display-namestring required

The mutable display name for the Legal-Person

application-status'referred' | 'errored' | 'declined' | 'submitted' | 'accepted'

Status of the current application

legal-person-status'restricted' | 'onboarding-declined' | 'onboarded' | 'verified' | 'onboarding'

Status of the legal person

status-changed-atstring date-time

ISO 8601 formatted date-time.

created-atstring date-time required

ISO 8601 formatted date-time.

legal-namestring

A read-only, human readable label derived from claims

Example response

{
  "latest-decision": {
    "verification-url": "/v0/verifications/vn.IHZlcmlmaWNhdGlvbi1pZA",
    "decision-user-url": "/v0/users/ur.ICAgICAgICAgdXNlci1pZA",
    "decision-user-username": "user@example.com"
  },
  "latest-risk-rating-url": "/v0/risk-ratings/rr.ICByaXNrLXJhdGluZy1pZA",
  "display-name": "Company name"
}

Changes