Get Proof Types#

Returns the list of proof types for identities or addresses.

Request#

HTTP Method: GET

URI Path: /v3/proof_types

Note

For all returned data attributes, see Proof Types Object.

URI Query Parameters#

Name

Type

Is Required?

Description

filter[<filter_name>]

string

No

Filtering

fields[proof_types]

string

No

Sparse fieldsets

Filters#

Filter Name

Type

Allow Blank

Allow Array

Filters by:

id

string

No

Yes

The id field.

entity_type

string

No

Yes

The entity_type field. Accepted values: personal, business, address. Any other value returns 400 Bad Request.

Examples#

http

1GET /v3/proof_types HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Authorization: Bearer [access token]

curl

1curl -i -X GET https://api.didww.com/v3/proof_types -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]"

response

 1HTTP/1.1 200 OK
 2Content-Type: application/vnd.api+json
 3
 4{
 5    "data": [
 6        {
 7            "id": "d2c1b3fb-29f7-46ca-ba82-b617f4630b78",
 8            "type": "proof_types",
 9            "attributes": {
10                "name": "Copy of Phone Bill",
11                "entity_type": "address"
12            }
13        },
14        {
15            "id": "ab1fb565-ac55-4c73-bc55-64dc61e70169",
16            "type": "proof_types",
17            "attributes": {
18                "name": "Utility Bill",
19                "entity_type": "address"
20            }
21        },
22        {
23            "id": "634aea96-43d9-49a2-bd4e-6e8e2ce4e5e9",
24            "type": "proof_types",
25            "attributes": {
26                "name": "Rental Receipt",
27                "entity_type": "address"
28            }
29        },
30        {
31            "id": "49f42cbd-d051-43e0-9d30-883e154bad0d",
32            "type": "proof_types",
33            "attributes": {
34                "name": "Other",
35                "entity_type": "address"
36            }
37        }
38    ],
39    "meta": {
40        "api_version": "2026-11-19"
41    }
42}

Other Responses#

Code

Success

Description

400

No

Bad Request

401

No

Unauthorized

429

No

The request budget of the account for the current window is spent (too_many_requests). Retry-After gives the number of seconds to wait.