# 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: |
| --- | --- | --- | --- | --- |
| entity\_type | `string` | Yes | Yes | The `entity_type` field. |

## Examples

Simple RequestFilter by entity\_type

[[DIDWW-API-EXAMPLE-START]]

http

```
GET /v3/proof_types 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/proof_types -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": "d2c1b3fb-29f7-46ca-ba82-b617f4630b78",
                        "type": "proof_types",
                        "attributes": {
                                "name": "Copy of Phone Bill",
                                "entity_type": "Address"
                        }
                },
                {
                        "id": "ab1fb565-ac55-4c73-bc55-64dc61e70169",
                        "type": "proof_types",
                        "attributes": {
                                "name": "Utility Bill",
                                "entity_type": "Address"
                        }
                },
                {
                        "id": "634aea96-43d9-49a2-bd4e-6e8e2ce4e5e9",
                        "type": "proof_types",
                        "attributes": {
                                "name": "Rental Receipt",
                                "entity_type": "Address"
                        }
                },
                {
                        "id": "49f42cbd-d051-43e0-9d30-883e154bad0d",
                        "type": "proof_types",
                        "attributes": {
                                "name": "Other",
                                "entity_type": "Address"
                        }
                }
        ],
        "meta": {
                "total_records": 4,
                "api_version": "2026-04-16"
        }
}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
GET /v3/proof_types?filter%5Bentity_type%5D=Address 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/proof_types?filter%5Bentity_type%5D=Address' -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": "58b80af0-81d5-4828-abd8-37ea48f3893d",
                 "type": "proof_types",
                 "attributes":          {
                        "name": "Copy of Phone Bill",
                        "entity_type": "Address"
                 }
          },
                        {
                 "id": "d29b6637-36fe-477c-941c-19965a81e96c",
                 "type": "proof_types",
                 "attributes":          {
                        "name": "Utility Bill",
                        "entity_type": "Address"
                 }
          },
                        {
                 "id": "af64c2cb-8db2-4076-a667-9014a48f24a4",
                 "type": "proof_types",
                 "attributes":          {
                        "name": "Rental Receipt",
                        "entity_type": "Address"
                 }
          },
                        {
                 "id": "9e24acf0-fc18-4079-b546-4f316d0e9003",
                 "type": "proof_types",
                 "attributes":          {
                        "name": "Other",
                        "entity_type": "Address"
                 }
          }
   ],
   "meta":    {
          "total_records": 4,
          "api_version": "2026-04-16"
   }
}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 401 | No | [Unauthorized](../../../configuration.html#api-key) |

On this page