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

Optional

Filtering

include

string

Optional

Inclusion

sort

string

Optional

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

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
                    },
                    "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": {
                "total_records": 4,
                "api_version": "2021-12-15"
            },
            "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