Skip to main content
POST
/
v1
/
key
/
generate
Generate a cryptographic key
curl --request POST \
  --url https://orchestrator.control.coincover.com/v1/key/generate \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "user_identifier": "john.doe@example.com",
  "verification_id": "a7b8c9d0-e1f2-4345-a678-901234567890"
}
'
{
  "key_id": "550e8400-e29b-41d4-a716-446655440000",
  "public_key": "30820122300d06092a864886f70d...",
  "signature": "MEUCIQDxyz123abc456def789ghi..."
}

Authorizations

X-API-Key
string
header
required

API key for authentication and authorization

Body

application/json
user_identifier
string
required

User identifier (REQUIRED)

Example:

"john.doe@example.com"

verification_id
string
required

Verification ID from a previous verification. (REQUIRED) Must exist in identity_verifications table and belong to the user associated with the organisation.

Example:

"a7b8c9d0-e1f2-4345-a678-901234567890"

Response

200 - application/json

Key generated successfully

key_id
string<uuid>
required

Unique identifier for the generated key (UUID)

Example:

"550e8400-e29b-41d4-a716-446655440000"

public_key
string
required

Public key in hexadecimal format

Example:

"30820122300d06092a864886f70d..."

signature
string
required

Signature of the key in base64 format

Example:

"MEUCIQDxyz123abc456def789ghi..."