Update Identity
Description
Update the settings of a single Identity owned by your account.
Request
HTTP Method: PATCH
URI Path: /v3/identities/
URI Query Parameters:
Name |
Type |
Is Required? |
Description |
---|---|---|---|
id |
|
Yes |
Unique ID identifier of the Identity. |
Attributes
Name |
Type |
Is Required? |
Description |
---|---|---|---|
first_name |
|
Yes |
First name of the personal identity. |
last_name |
|
Yes |
Last name of the personal identity. |
phone_number |
|
Yes |
Phone number of the personal identity. |
personal_tax_id |
|
No |
Personal tax ID of the personal identity. |
birth_date |
|
No |
Birth date of the personal identity in ISO 8601 format. |
id_number |
|
No |
ID number of the personal identity. |
description |
|
No |
Description of the personal identity. |
external_reference_id |
|
No |
Identifier for identity in external system |
Name |
Type |
Is Required? |
Description |
---|---|---|---|
company_name |
|
Yes |
Company name of the business identity. |
company_reg_number |
|
No |
Company registration number of the business identity. |
vat_id |
|
No |
Company VAT ID of the business identity. |
first_name |
|
Yes |
Company’s representative First name of the business identity. |
last_name |
|
Yes |
Company’s representative Last name of the business identity. |
phone_number |
|
Yes |
Company’s representative Phone number of the business identity. |
personal_tax_id |
|
No |
Company’s representative Tax ID of the business identity. |
birth_date |
|
No |
Company’s representative Birth date of the business identity in ISO 8601 format. |
id_number |
|
No |
Company’s representative ID number of the business identity. |
description |
|
No |
Company’s representative description of the business identity. |
external_reference_id |
|
No |
Identifier for identity in external system |
Examples
PATCH /v3/identities/46e129f1-deaa-44db-8915-2646de4d4c70 HTTP/1.1
Host: api.didww.com
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Api-Key: [API token]
{
"data": {
"id": "46e129f1-deaa-44db-8915-2646de4d4c70",
"type": "identities",
"attributes": {
"birth_date": "2000-01-01",
"phone_number": "353-1-9015266",
"last_name": "Smith",
"vat_id": null,
"id_number": "0000000000",
"description": "string",
"personal_tax_id": "string"
}
}
}
curl -i -X PATCH https://api.didww.com/v3/identities/46e129f1-deaa-44db-8915-2646de4d4c70 -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json" --data-raw '{"data": {"attributes": {"birth_date": "2000-01-01", "description": "string", "id_number": "0000000000", "last_name": "Smith", "personal_tax_id": "string", "phone_number": "353-1-9015266", "vat_id": null}, "id": "46e129f1-deaa-44db-8915-2646de4d4c70", "type": "identities"}}'
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json
{
"data": {
"id": "0c95a4c3-c5e6-4ea0-a8ba-bfb65850913c",
"type": "identities",
"attributes": {
"first_name": "Jane",
"last_name": "Smith",
"phone_number": "353-1-9015266",
"id_number": "0000000000",
"birth_date": "2000-01-01",
"company_name": "",
"company_reg_number": null,
"vat_id": null,
"description": "string",
"personal_tax_id": "string",
"identity_type": "Personal",
"created_at": "2020-09-14T07:29:41.393Z"
},
"relationships": {
"country": {
"links": {
"self": "https://sandbox-api.didww.com/v3/identities/0c95a4c3-c5e6-4ea0-a8ba-bfb65850913c/relationships/country",
"related": "https://sandbox-api.didww.com/v3/identities/0c95a4c3-c5e6-4ea0-a8ba-bfb65850913c/country"
}
},
"proofs": {
"links": {
"self": "https://sandbox-api.didww.com/v3/identities/0c95a4c3-c5e6-4ea0-a8ba-bfb65850913c/relationships/proofs",
"related": "https://sandbox-api.didww.com/v3/identities/0c95a4c3-c5e6-4ea0-a8ba-bfb65850913c/proofs"
}
},
"addresses": {
"links": {
"self": "https://sandbox-api.didww.com/v3/identities/0c95a4c3-c5e6-4ea0-a8ba-bfb65850913c/relationships/addresses",
"related": "https://sandbox-api.didww.com/v3/identities/0c95a4c3-c5e6-4ea0-a8ba-bfb65850913c/addresses"
}
},
"permanent_documents": {
"links": {
"self": "https://sandbox-api.didww.com/v3/identities/0c95a4c3-c5e6-4ea0-a8ba-bfb65850913c/relationships/permanent_documents",
"related": "https://sandbox-api.didww.com/v3/identities/0c95a4c3-c5e6-4ea0-a8ba-bfb65850913c/permanent_documents"
}
}
}
},
"meta": {
"api_version": "2022-05-10"
}
}
Other Responses
Code |
Success |
Description |
---|---|---|
404 |
No |
|
401 |
No |