Create Identity

Create single Identity owned by your account.

Request

HTTP Method: POST

URI Path: /v3/identities/

Includes

Value	Description
country	Country Object
birth_country	Country Object
proofs	Proofs Object
addresses	Addresses Object
addresses.country	Country Object
proofs.proof_type	Proof Types Object
permanent_documents	Permanent Documents Object
permanent_documents.template	Supporting Document Template Object

Request Body Object Attributes

PersonalBusiness

Name	Type	Is Required?	Description
first_name	string	Yes	First name of the personal identity.
last_name	string	Yes	Last name of the personal identity.
phone_number	string	Yes	Phone number of the personal identity.
personal_tax_id	string	No	Personal tax ID of the personal identity.
birth_date	string	No	Birth date of the personal identity in ISO 8601 format.
id_number	string	No	ID number of the personal identity.
description	string	No	Description of the personal identity.
external_reference_id	string	No	Identifier for identity in external system
identity_type	string	Yes	Type of identity. Write personal to create a personal identity.
contact_email	string	No	Contact email address of identity.

Request Body Object Relationships

Title	Type	Description
country	Country Object	Specifies the country for identity.
birth_country	Country Object	Specifies the birth country for identity. In version 2026-04-16, it is handled separately from country and is not auto-assigned.

Note

Assigning country does not automatically assign birth_country. Set birth_country explicitly when needed.

Examples

Create Personal IdentityCreate Personal Identity with Country and Birth CountryCreate Business Identity

http

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

{
  "data": {
    "type": "identities",
    "attributes": {
      "first_name": "string",
      "last_name": "string",
      "phone_number": "string",
      "birth_date": null,
      "id_number": "string",
      "description": "string",
      "personal_tax_id": "string",
      "external_reference_id": "string",
      "identity_type": "personal",
      "contact_email": "string"
    }
  }
}

curl

curl -i -X POST https://api.didww.com/v3/identities -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json" --data-raw '{"data": {"attributes": {"birth_date": null, "contact_email": "string", "description": "string", "external_reference_id": "string", "first_name": "string", "id_number": "string", "identity_type": "personal", "last_name": "string", "personal_tax_id": "string", "phone_number": "string"}, "type": "identities"}}'

response

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

{
  "data": {
    "id": "39623bf9-381f-4da6-ab29-2d3eb8783d81",
    "type": "identities",
    "attributes": {
      "first_name": "string",
      "last_name": "string",
      "phone_number": "string",
      "id_number": "string",
      "birth_date": null,
      "company_name": null,
      "company_reg_number": null,
      "vat_id": null,
      "description": "string",
      "personal_tax_id": "string",
      "identity_type": "personal",
      "created_at": "2021-03-22T11:53:32.240Z",
      "external_reference_id": null,
      "verified": false,
      "contact_email": "string"
    },
    "relationships": {
      "country": {
        "links": {
          "self": "https://sandbox-api.didww.com/v3/identities/39623bf9-381f-4da6-ab29-2d3eb8783d81/relationships/country",
          "related": "https://sandbox-api.didww.com/v3/identities/39623bf9-381f-4da6-ab29-2d3eb8783d81/country"
        }
      },
      "proofs": {
        "links": {
          "self": "https://sandbox-api.didww.com/v3/identities/39623bf9-381f-4da6-ab29-2d3eb8783d81/relationships/proofs",
          "related": "https://sandbox-api.didww.com/v3/identities/39623bf9-381f-4da6-ab29-2d3eb8783d81/proofs"
        }
      },
      "addresses": {
        "links": {
          "self": "https://sandbox-api.didww.com/v3/identities/39623bf9-381f-4da6-ab29-2d3eb8783d81/relationships/addresses",
          "related": "https://sandbox-api.didww.com/v3/identities/39623bf9-381f-4da6-ab29-2d3eb8783d81/addresses"
        }
      },
      "permanent_documents": {
        "links": {
          "self": "https://sandbox-api.didww.com/v3/identities/39623bf9-381f-4da6-ab29-2d3eb8783d81/relationships/permanent_documents",
          "related": "https://sandbox-api.didww.com/v3/identities/39623bf9-381f-4da6-ab29-2d3eb8783d81/permanent_documents"
        }
      }
    }
  },
  "meta": {
    "api_version": "2026-04-16"
  }
}

Other Responses

Code	Success	Description
404	No	Not Found
401	No	Unauthorized