Generate DID

post

https://api.blockpeer.finance/api/blockpeer-trade/trade/did/generate

Generates a Decentralized Identifier (DID) document for a given domain. The generated DID follows the did:web method, producing a DID document tied to your domain's identity.

Auto-Deployment (Netlify)

If you'd like Blockpeer to automatically deploy your DID, provide only the companyName field. Blockpeer will provision a domain on Netlify, generate your DID document, and deploy it to edocs-<companyName>.netlify.app/.well-known/did.json — no manual setup required.

Custom Domain

If you prefer to host your DID on your own domain, provide only the customDomain field (e.g. blockpeer.net). Blockpeer will generate the DID document, but you are responsible for manually deploying it to <yourdomain>/.well-known/did.json to make it publicly resolvable.

⚠️ Warning

The Netlify auto-deployment option ( companyName ) is intended for demo and testing purposes only. The generated subdomain (edocs-<company-name>.netlify.app) should not be used in production environments.
For production use, always provide a customDomain and manually host the DID document at https://<your-domain>/.well-known/did.json to ensure full control, reliability, and security over your DID infrastructure.

Body Params

Generate DID request details. Provide either companyName OR customDomain — not both.

companyName

string

Provide your company name for Netlify auto-deployment. Our system will automatically create edocs-<company-name>.netlify.app and deploy the DID document. No manual setup required.

Example: blockpeer → edocs-blockpeer.netlify.app

⚠️ Do not use this field together with customDomain.

customDomain

string

Provide your full custom domain. After generation, you must manually host the DID document at https://<your-domain>/.well-known/did.json.

Example: demo.example.com

⚠️ Do not use this field together with companyName.

address

string

LEI

string

20-character unique identifier assigned to your company for financial transactions. Required by many banks and regulatory authorities. If you don't have one, you can leave this blank.

Headers

Idempotency-Key

string

Unique key to ensure idempotency for API requests.

X-External-Id

string

Unique external ID for tracking purposes, can be used for debugging and analytics.

Responses

Auto-Deployment (Netlify)

Custom Domain

⚠️ Warning

200The DID json has been successfully generated and returned.

500An internal error occurred while processing the DNS URL. This may include network configuration issues or unexpected server failures.