# 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](proof-types-object.html).

### URI Query Parameters

| Name | Type | Is Required? | Description |
| --- | --- | --- | --- |
| filter[<filter\_name>] | `string` | No | [Filtering](../../../specification/filtering.html#api-filters) |
| fields[proof\_types] | `string` | No | [Sparse fieldsets](../../../specification/sparse-fieldsets.html#api-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

Simple RequestFilter by entity\_type

[[DIDWW-API-EXAMPLE-START]]

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}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/proof_types?filter%5Bentity_type%5D=address 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?filter%5Bentity_type%5D=address' -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}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 400 | No | [Bad Request](../../../specification/errors/index.html#api-bad-request) |
| 401 | No | [Unauthorized](../../authentication.html#authentication-v35) |
| 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. |
