# Get Identity

Returns a single Identity in the account.

## Request

HTTP Method: `GET`

URI Path: `/v3/identities/{id}`

Note

For all returned data attributes, see [Identity Object](identity-object.html).

### URI Query Parameters

| Name | Type | Is Required? | Description |
| --- | --- | --- | --- |
| id | `string` | Yes | Unique ID identifier of the Identity. |
| include | `string` | No | Related resources to include in the response. See [Inclusion](../../../specification/includes.html#api-includes). |

### Includes

| Value | Description |
| --- | --- |
| country | [Country Object](../../coverage-resources/countries/country-object.html#country-object-v34) |
| birth\_country | [Country Object](../../coverage-resources/countries/country-object.html#country-object-v34) |
| proofs | [Proofs Object](../proofs/proofs-object.html#proofs-object-v34) |
| addresses | [Addresses Object](../addresses/address-object.html#addresses-object-v34) |
| addresses.country | [Country Object](../../coverage-resources/countries/country-object.html#country-object-v34) |
| proofs.proof\_type | [Proof Types Object](../proof-types/proof-types-object.html#proof-types-object-v34) |
| permanent\_documents | [Permanent Documents Object](../permanent-documents/permanent-documents-object.html#permanent-documents-object-v34) |
| permanent\_documents.template | [Supporting Document Template Object](../supporting-document-templates/supporting-document-templates-object.html#supporting-document-templates-object-v34) |

## Examples

Simple RequestInclude country

[[DIDWW-API-EXAMPLE-START]]

http

```
GET /v3/identities/0083c7f2-b030-491f-91b3-54597967ca38 HTTP/1.1
Host: api.didww.com
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Api-Key: [API token]
```

curl

```
curl -i -X GET https://api.didww.com/v3/identities/0083c7f2-b030-491f-91b3-54597967ca38 -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json"
```

response

```
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
    "data": {
        "id": "0083c7f2-b030-491f-91b3-54597967ca38",
        "type": "identities",
        "attributes": {
            "first_name": "Jane",
            "last_name": "Smith",
            "phone_number": "1276813663",
            "id_number": "",
            "birth_date": null,
            "company_name": null,
            "company_reg_number": null,
            "vat_id": null,
            "description": null,
            "personal_tax_id": null,
            "identity_type": "personal",
            "created_at": "2025-04-11T13:03:17.029Z",
            "external_reference_id": null,
            "verified": false,
            "contact_email": "contact@email.com"
        },
        "relationships": {
            "country": {
                "links": {
                    "self": "https://api.didww.com/v3/identities/0083c7f2-b030-491f-91b3-54597967ca38/relationships/country",
                    "related": "https://api.didww.com/v3/identities/0083c7f2-b030-491f-91b3-54597967ca38/country"
                }
            },
            "birth_country": {
                "links": {
                    "self": "https://api.didww.com/v3/identities/0083c7f2-b030-491f-91b3-54597967ca38/relationships/birth_country",
                    "related": "https://api.didww.com/v3/identities/0083c7f2-b030-491f-91b3-54597967ca38/relationships/birth_country"
                }
            },
            "proofs": {
                "links": {
                    "self": "https://api.didww.com/v3/identities/0083c7f2-b030-491f-91b3-54597967ca38/relationships/proofs",
                    "related": "https://api.didww.com/v3/identities/0083c7f2-b030-491f-91b3-54597967ca38/proofs"
                }
            },
            "addresses": {
                "links": {
                    "self": "https://api.didww.com/v3/identities/0083c7f2-b030-491f-91b3-54597967ca38/relationships/addresses",
                    "related": "https://sandbox-api.didww.com/v3/identities/0083c7f2-b030-491f-91b3-54597967ca38/addresses"
                }
            },
            "permanent_documents": {
                "links": {
                    "self": "https://api.didww.com/v3/identities/0083c7f2-b030-491f-91b3-54597967ca38/relationships/permanent_documents",
                    "related": "https://api.didww.com/v3/identities/0083c7f2-b030-491f-91b3-54597967ca38/permanent_documents"
                }
            }
        }
    },
    "meta": {
        "api_version": "2026-04-16"
    }
}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
GET /v3/identities/0083c7f2-b030-491f-91b3-54597967ca38?include=country HTTP/1.1
Host: api.didww.com
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Api-Key: [API token]
```

curl

```
curl -i -X GET 'https://api.didww.com/v3/identities/0083c7f2-b030-491f-91b3-54597967ca38?include=country' -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json"
```

response

```
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
    "data": {
        "id": "0083c7f2-b030-491f-91b3-54597967ca38",
        "type": "identities",
        "attributes": {
            "first_name": "Jane",
            "last_name": "Smith",
            "phone_number": "1276813663",
            "id_number": "",
            "birth_date": null,
            "company_name": null,
            "company_reg_number": null,
            "vat_id": null,
            "description": null,
            "personal_tax_id": null,
            "identity_type": "personal",
            "created_at": "2021-04-20T13:37:21.594Z",
            "external_reference_id": null,
            "verified": false
        },
        "relationships": {
            "country": {
                "links": {
                    "self": "https://api.didww.com/v3/identities/0083c7f2-b030-491f-91b3-54597967ca38/relationships/country",
                    "related": "https://api.didww.com/v3/identities/0083c7f2-b030-491f-91b3-54597967ca38/country"
                },
                "data": {
                    "type": "countries",
                    "id": "b9dce495-1085-4452-8224-6761dd3cc15a"
                }
            },
            "birth_country": {
                "links": {
                    "self": "https://api.didww.com/v3/identities/0083c7f2-b030-491f-91b3-54597967ca38/relationships/birth_country",
                    "related": "https://api.didww.com/v3/identities/0083c7f2-b030-491f-91b3-54597967ca38/relationships/birth_country"
                }
            }
        }
    },
    "included": [
        {
            "id": "b9dce495-1085-4452-8224-6761dd3cc15a",
            "type": "countries",
            "attributes": {
                "name": "Andorra",
                "prefix": "376",
                "iso": "AD"
            }
        }
    ],
    "meta": {
        "api_version": "2026-04-16"
    }
}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 404 | No | [Not Found](../../../specification/errors/index.html#api-not-found) |
| 401 | No | [Unauthorized](../../../configuration.html#api-key) |

On this page