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 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 associated to this proof.

entity

string

Yes

Allowed entity types: identities or addresses

Examples#

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}

Other Responses#

Code

Success

Description

400

No

Bad Request. The body carries a member the API does not accept.

401

No

Unauthorized

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.

422

No

Validation error. 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.