# Create Proof

Creates an identity proof.

## Request

HTTP Method: `POST`

URI Path: `/v3/proofs`

### Request Body Object Attributes

| Name | Type | Is Required? | Description |
| --- | --- | --- | --- |
| external\_reference\_id | `string` | No | Optional identifier for the proof in the customer's external system. Maximum length is 100 characters. |

### Request Body Object Relationships

| Name | Type | Is Required? | Description |
| --- | --- | --- | --- |
| files | `array` | Yes | The IDs of the [encrypted files](../encrypted-files/encrypted-files-object.html#encrypted-files-object-v35) associated to this proof. From 1 to 5 files: more than 5 returns `422 Unprocessable Entity`. |
| proof\_type | `string` | Yes | The ID of [proof type](../proof-types/proof-types-object.html#proof-types-object-v35) associated to this proof. |
| entity | `string` | Yes | Allowed entity types: `identities` or `addresses` |

## Examples

Resource Creation Example: IdentitiesResource Creation Example: Addresses

[[DIDWW-API-EXAMPLE-START]]

http

```
 1POST /v3/proofs HTTP/1.1
 2Host: api.didww.com
 3Content-Type: application/vnd.api+json
 4Accept: application/vnd.api+json
 5Authorization: Bearer [access token]
 6
 7{
 8  "data": {
 9    "type": "proofs",
10    "relationships": {
11      "files": {
12        "data": [
13          {
14            "id": "cc52b6b3-0627-47d3-a1c9-b54d3de42813",
15            "type": "encrypted_files"
16          }
17        ]
18      },
19      "proof_type": {
20        "data": {
21          "id": "d2c1b3fb-29f7-46ca-ba82-b617f4630b78",
22          "type": "proof_types"
23        }
24      },
25      "entity": {
26        "data": {
27          "id": "54c92d8e-f135-4b55-ac48-748d44437509",
28          "type": "identities"
29        }
30      }
31    }
32  }
33}
```

curl

```
1curl -i -X POST https://api.didww.com/v3/proofs -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]" --data-raw '{"data": {"relationships": {"entity": {"data": {"id": "54c92d8e-f135-4b55-ac48-748d44437509", "type": "identities"}}, "files": {"data": [{"id": "cc52b6b3-0627-47d3-a1c9-b54d3de42813", "type": "encrypted_files"}]}, "proof_type": {"data": {"id": "d2c1b3fb-29f7-46ca-ba82-b617f4630b78", "type": "proof_types"}}}, "type": "proofs"}}'
```

response

```
 1HTTP/1.1 201 Created
 2Content-Type: application/vnd.api+json
 3
 4{
 5    "data": {
 6        "id": "84155378-88d5-456e-844d-103596e3fb2c",
 7        "type": "proofs",
 8        "attributes": {
 9            "created_at": "2021-03-28T18:01:50.387Z",
10            "expires_at": null,
11            "external_reference_id": null
12        },
13        "relationships": {
14            "proof_type": {
15                "links": {
16                    "self": "https://api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c/relationships/proof_type",
17                    "related": "https://api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c/proof_type"
18                }
19            },
20            "entity": {
21                "links": {
22                    "self": "https://api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c/relationships/entity",
23                    "related": "https://api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c/entity"
24                }
25            }
26        }
27    },
28    "meta": {
29        "api_version": "2026-11-19"
30    }
31}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
 1POST /v3/proofs HTTP/1.1
 2Host: api.didww.com
 3Content-Type: application/vnd.api+json
 4Accept: application/vnd.api+json
 5Authorization: Bearer [access token]
 6
 7{
 8  "data": {
 9    "type": "proofs",
10    "relationships": {
11      "files": {
12        "data": [
13          {
14            "id": "cc52b6b3-0627-47d3-a1c9-b54d3de42813",
15            "type": "encrypted_files"
16          }
17        ]
18      },
19      "proof_type": {
20        "data": {
21          "id": "d2c1b3fb-29f7-46ca-ba82-b617f4630b78",
22          "type": "proof_types"
23        }
24      },
25      "entity": {
26        "data": {
27          "id": "54c92d8e-f135-4b55-ac48-748d44437509",
28          "type": "addresses"
29        }
30      }
31    }
32  }
33}
```

curl

```
1curl -i -X POST https://api.didww.com/v3/proofs -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]" --data-raw '{"data": {"relationships": {"entity": {"data": {"id": "54c92d8e-f135-4b55-ac48-748d44437509", "type": "addresses"}}, "files": {"data": [{"id": "cc52b6b3-0627-47d3-a1c9-b54d3de42813", "type": "encrypted_files"}]}, "proof_type": {"data": {"id": "d2c1b3fb-29f7-46ca-ba82-b617f4630b78", "type": "proof_types"}}}, "type": "proofs"}}'
```

response

```
 1HTTP/1.1 201 Created
 2Content-Type: application/vnd.api+json
 3
 4{
 5    "data": {
 6        "id": "84155378-88d5-456e-844d-103596e3fb2c",
 7        "type": "proofs",
 8        "attributes": {
 9            "created_at": "2021-03-28T18:01:50.387Z",
10            "expires_at": null,
11            "external_reference_id": null
12        },
13        "relationships": {
14            "proof_type": {
15                "links": {
16                    "self": "https://api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c/relationships/proof_type",
17                    "related": "https://api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c/proof_type"
18                }
19            },
20            "entity": {
21                "links": {
22                    "self": "https://api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c/relationships/entity",
23                    "related": "https://api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c/entity"
24                }
25            }
26        }
27    },
28    "meta": {
29        "api_version": "2026-11-19"
30    }
31}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 400 | No | [Bad Request](../../../specification/errors/index.html#api-bad-request). The body carries a member the API does not accept. |
| 401 | No | [Unauthorized](../../authentication.html#authentication-v35) |
| 403 | No | The access token carries the `read` scope, which does not cover this method (title `Insufficient scope`). The response carries `WWW-Authenticate: Bearer error="insufficient_scope"`. See [Scopes](../../authentication.html#authentication-scopes-v35). |
| 422 | No | [Validation error](../../../specification/errors/index.html#api-validation-error-object). The proof was rejected. |
| 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. |
