Get Identities

Description

Returns a list of Identities on your account.

Request

HTTP Method: GET

URI Path: /v3/identities

URI Query Parameters:

Name	Type	Is Required?	Description
filter[<filter_name>]	string, DateTime	No	Filtering
includes	string	No	Inclusion
sort	string	No	Inclusion

Includes:

Value	Description
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.
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.

Fielding:

Value	Returns:
first_name	The first_name attribute.
last_name	The last_name attribute.
phone_number	The phone_number attribute.
id_number	The id_number attribute.
birth_date	The birth_date attribute.
company_name	The company_name attribute.
company_reg_number	The company_reg_number attribute.
vat_id	The vat_id attribute.
description	The description attribute.
personal_tax_id	The personal_tax_id attribute.
identity_type	The identity_type attribute.
created_at	The created_at attribute.
external_reference_id	The external_reference_id attribute.
verified	The verified attribute.

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

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]

Other Responses

Code	Success	Description
401	No	Unauthorized