Individual

Read individual

GET/v4/service/platform/individual/{individualId}

Reads an individual. With a token of an individual (an individual token, a token of the privacy dashboard login or of the identity provider of the organisation), the individual can read only its own record: another ID gets 403.

Read individual

Language of the request sample

curl 'https://demo-api.igrant.io/v4/service/platform/individual/6af0821c38e8f33dcf79962e' \
  -H 'Authorization: ApiKey <your-api-key>'

{
  "individual": {
    "id": "6af0821c38e8f33dcf79962e",
    "externalId": "customer-1002",
    "externalIdType": "customerNumber",
    "identityProviderId": "",
    "name": "Sam Doe",
    "iamId": "",
    "email": "",
    "phone": "",
    "pushNotificationToken": "<push-notification-token>",
    "deviceType": "ios",
    "mapperId": ""
  }
}

Authorizations

Authorizationstringheaderrequired
Your API key with the prefix ApiKey: ApiKey <your-api-key>. Get an API key.
Scope:individuals:read

Path parameters

individualIdstringrequired
Individual ID.
Example:"6af0821c38e8f33dcf79962e"

Response

application/json

The individual.

individualobject
A person whose consent the organisation records, for example a customer. The record can point to the person in another system through externalId. Keep personal data in it to the minimum that you need.