Get Identities

Returns a list of Identities on your account.

Request

HTTP Method: GET

URI Path: /v3/identities

Note

For all returned data attributes, see Identity Object.

URI Query Parameters

Name	Type	Is Required?	Description
include	string	No	Inclusion
filter[<filter_name>]	string, DateTime	No	Filtering
fields[identities]	string	No	Sparse fieldsets
sort	string	No	Sorting

Includes

Value	Description
country	Country Object
birth_country	Country Object
proofs	Proofs Object
addresses	Addresses Object
addresses.country	Country Object
proofs.proof_type	Proof Types Object
permanent_documents	Permanent Documents Object
permanent_documents.template	Supporting Document Template Object

Filters

Filter Name	Type	Allow Blank	Allow Array	Filters by:
first_name	string	Yes	Yes	The first_name field.
first_name_contains	string	Yes	Yes	The firs_name_contains field.
last_name	string	Yes	Yes	The last_name field.
last_name_contains	string	Yes	Yes	The last_name_contains field.
phone_number	string	Yes	Yes	The phone_number field.
phone_number_contains	string	Yes	No	The phone_number_contains field.
id_number	string	Yes	Yes	The id_number field.
id_number_contains	string	Yes	Yes	The id_number_contains field.
birth_date	DateTime	No	Yes	The birth_date field.
company_name	string	Yes	Yes	The company_name field.
company_name_contains	string	Yes	Yes	The company_name_contains field.
company_reg_number	string	Yes	Yes	The company_reg_number field.
company_reg_number_contains	string	Yes	Yes	The company_reg_number_contains field.
vat_id	string	Yes	Yes	The vat_id field.
vat_id_contains	string	Yes	Yes	The vat_id_contains field.
description	string	Yes	Yes	The description field.
description_contains	string	Yes	Yes	The description_contains field
personal_tax_id	string	Yes	Yes	The personal_tax_id field.
personal_tax_id_contains	string	Yes	Yes	The personal_tax_id field.
identity_type	string	No	No	The identity_type field. Possible values: any, personal, business.
country.id	string	No	No	The country.id field.
external_reference_id	string	No	No	The external_reference_id field.

Sorting

Value	Sorts by:
first_name	The first_name field.
last_name	The last_name field.
phone_number	The phone_number field.
id_number	The id_number field.
birth_date	The birth_date field.
company_name	The company_name field.
company_reg_number	The company_reg_number field.
vat_id	The vat_id field.
description	The description field.
personal_tax_id	The personal_tax_id field.

Examples

Simple RequestFilter first_name_containsInclude country

http

GET /v3/identities 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 -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": "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": null,
                        "company_reg_number": null,
                        "vat_id": null,
                        "description": "Personal details",
                        "personal_tax_id": null,
                        "identity_type": "personal",
                        "created_at": "2020-09-14T07:29:41.393Z",
                        "external_reference_id": null,
                        "verified": false,
                        "contact_email": "contact@email.com"
                    },
                    "relationships": {
                        "country": {
                            "links": {
                                "self": "https://api.didww.com/v3/identities/0c95a4c3-c5e6-4ea0-a8ba-bfb65850913c/relationships/country",
                                "related": "https://api.didww.com/v3/identities/0c95a4c3-c5e6-4ea0-a8ba-bfb65850913c/country"
                            }
                        },
                        "birth_country": {
                            "links": {
                                "self": "https://api.didww.com/v3/identities/0c95a4c3-c5e6-4ea0-a8ba-bfb65850913c/relationships/birth_country",
                                "related": "https://api.didww.com/v3/identities/0c95a4c3-c5e6-4ea0-a8ba-bfb65850913c/relationships/birth_country"
                            }
                        },
                        "proofs": {
                            "links": {
                                "self": "https://api.didww.com/v3/identities/0c95a4c3-c5e6-4ea0-a8ba-bfb65850913c/relationships/proofs",
                                "related": "https://api.didww.com/v3/identities/0c95a4c3-c5e6-4ea0-a8ba-bfb65850913c/proofs"
                            }
                        },
                        "addresses": {
                            "links": {
                                "self": "https://api.didww.com/v3/identities/0c95a4c3-c5e6-4ea0-a8ba-bfb65850913c/relationships/addresses",
                                "related": "https://api.didww.com/v3/identities/0c95a4c3-c5e6-4ea0-a8ba-bfb65850913c/addresses"
                            }
                        },
                        "permanent_documents": {
                            "links": {
                                "self": "https://api.didww.com/v3/identities/0c95a4c3-c5e6-4ea0-a8ba-bfb65850913c/relationships/permanent_documents",
                                "related": "https://api.didww.com/v3/identities/0c95a4c3-c5e6-4ea0-a8ba-bfb65850913c/permanent_documents"
                            }
                        }
                    }
                }
            ],
            "meta": {
                "total_records": 4,
                "api_version": "2026-04-16"
            },
            "links": {
                "first": "https://sandbox-api.didww.com/v3/identities?page%5Bnumber%5D=1&page%5Bsize%5D=50",
                "last": "https://sandbox-api.didww.com/v3/identities?page%5Bnumber%5D=1&page%5Bsize%5D=50"
            }
        }

Other Responses

Code	Success	Description
401	No	Unauthorized