# 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 | `string` | Yes | The ID of [encrypted files](../encrypted-files/encrypted-files-object.html#encrypted-files-object-v34) associated to this proof. |
| proof\_types | `string` | Yes | The ID of [proof type](../proof-types/proof-types-object.html#proof-types-object-v34) 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

```
POST /v3/proofs HTTP/1.1
Host: api.didww.com
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Api-Key: [API token]

{
  "data": {
    "type": "proofs",
    "relationships": {
      "files": {
        "data": [
          {
            "id": "cc52b6b3-0627-47d3-a1c9-b54d3de42813",
            "type": "encrypted_files"
          }
        ]
      },
      "proof_type": {
        "data": {
          "id": "d2c1b3fb-29f7-46ca-ba82-b617f4630b78",
          "type": "proof_types"
        }
      },
      "entity": {
        "data": {
          "id": "54c92d8e-f135-4b55-ac48-748d44437509",
          "type": "identities"
        }
      }
    }
  }
}
```

curl

```
curl -i -X POST https://api.didww.com/v3/proofs -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json" --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

```
HTTP/1.1 201 Created
Content-Type: application/vnd.api+json

{
    "data": {
        "id": "84155378-88d5-456e-844d-103596e3fb2c",
        "type": "proofs",
        "attributes": {
            "created_at": "2021-03-28T18:01:50.387Z",
            "expires_at": null,
            "external_reference_id": null
        },
        "relationships": {
            "proof_type": {
                "links": {
                    "self": "https://sandbox-api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c/relationships/proof_type",
                    "related": "https://sandbox-api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c/proof_type"
                }
            },
            "entity": {
                "links": {
                    "self": "https://sandbox-api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c/relationships/entity",
                    "related": "https://sandbox-api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c/entity"
                }
            }
        }
    },
    "meta": {
        "api_version": "2026-04-16"
    }
}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
POST /v3/proofs HTTP/1.1
Host: api.didww.com
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Api-Key: [API token]

{
  "data": {
    "type": "proofs",
    "relationships": {
      "files": {
        "data": [
          {
            "id": "cc52b6b3-0627-47d3-a1c9-b54d3de42813",
            "type": "encrypted_files"
          }
        ]
      },
      "proof_type": {
        "data": {
          "id": "d2c1b3fb-29f7-46ca-ba82-b617f4630b78",
          "type": "proof_types"
        }
      },
      "entity": {
        "data": {
          "id": "54c92d8e-f135-4b55-ac48-748d44437509",
          "type": "addresses"
        }
      }
    }
  }
}
```

curl

```
curl -i -X POST https://api.didww.com/v3/proofs -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json" --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

```
HTTP/1.1 201 Created
Content-Type: application/vnd.api+json

{
    "data": {
        "id": "84155378-88d5-456e-844d-103596e3fb2c",
        "type": "proofs",
        "attributes": {
            "created_at": "2021-03-28T18:01:50.387Z",
            "expires_at": null,
            "external_reference_id": null
        },
        "relationships": {
            "proof_type": {
                "links": {
                    "self": "https://sandbox-api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c/relationships/proof_type",
                    "related": "https://sandbox-api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c/proof_type"
                }
            },
            "entity": {
                "links": {
                    "self": "https://sandbox-api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c/relationships/entity",
                    "related": "https://sandbox-api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c/entity"
                }
            }
        }
    },
    "meta": {
        "api_version": "2026-04-16"
    }
}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

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

On this page