---
title: "POST /v1alpha1/issuer/register"
method: POST
path: "/v1alpha1/issuer/register"
tags: ["IssuerService"]
---

# POST /v1alpha1/issuer/register

`POST /v1alpha1/issuer/register`

Register an issuer by providing the issuer details

## Request body

- RegisterIssuerRequest — Request to register an issuer
  - `issuer` Issuer — A Identity Issuer
    - `organization` string — The organization of the issuer
    - `subOrganization` string — The sub organization of the issuer
    - `commonName` string — The common name of the issuer Could be a FQDN or a FQDA
    - `verified` boolean — This will be set to true when issuer provides a valid proof of ownership of the common name on registration
    - `publicKey` Jwk — JWK represents: - a JSON Web Key (JWK) with the respective fields specific to RSA algorithms. - a Quantum JSON Web Key (QJWK) with the respective fields specific to AKP algorithms.
      - `alg` string — ALG represents the algorithm intended for use with the key. Example algorithms for Post-Quantum ML-DSA family: "ML-DSA-44", "ML-DSA-65", "ML-DSA-87". Some example algorithms are "RS256", "RS384", "RS512" for RSA algorithms.
      - `kty` string — KTY represents the key type parameter. It specifies the family of quantum algorithms used with the key, such as "AKP" for post quantum algorithms or "RSA" for non quantum algorithms.
      - `use` string — Use represents the intended use of the key. Some example values are "enc" and "sig".
      - `kid` string — KID represents the key ID. It is used to match a specific key.
      - `pub` string — The public key for the AKP kty.
      - `priv` string — The private key for the AKP kty.
      - `seed` string — Seed used to derive keys for ML-DSA alg.
      - `e` string — The exponent for the RSA public key.
      - `n` string — The modulus for the RSA public key.
      - `d` string — The private exponent for the RSA kty.
      - `p` string — The first prime factor for the RSA private key.
      - `q` string — The second prime factor for the RSA private key.
      - `dp` string — The first factor CRT exponent for the RSA private key.
      - `dq` string — The second factor CRT exponent for the RSA private key.
      - `qi` string — The first CRT coefficient for the RSA private key.
    - `privateKey` Jwk — JWK represents: - a JSON Web Key (JWK) with the respective fields specific to RSA algorithms. - a Quantum JSON Web Key (QJWK) with the respective fields specific to AKP algorithms.
      - `alg` string — ALG represents the algorithm intended for use with the key. Example algorithms for Post-Quantum ML-DSA family: "ML-DSA-44", "ML-DSA-65", "ML-DSA-87". Some example algorithms are "RS256", "RS384", "RS512" for RSA algorithms.
      - `kty` string — KTY represents the key type parameter. It specifies the family of quantum algorithms used with the key, such as "AKP" for post quantum algorithms or "RSA" for non quantum algorithms.
      - `use` string — Use represents the intended use of the key. Some example values are "enc" and "sig".
      - `kid` string — KID represents the key ID. It is used to match a specific key.
      - `pub` string — The public key for the AKP kty.
      - `priv` string — The private key for the AKP kty.
      - `seed` string — Seed used to derive keys for ML-DSA alg.
      - `e` string — The exponent for the RSA public key.
      - `n` string — The modulus for the RSA public key.
      - `d` string — The private exponent for the RSA kty.
      - `p` string — The first prime factor for the RSA private key.
      - `q` string — The second prime factor for the RSA private key.
      - `dp` string — The first factor CRT exponent for the RSA private key.
      - `dq` string — The second factor CRT exponent for the RSA private key.
      - `qi` string — The first CRT coefficient for the RSA private key.
    - `authType` 'ISSUER_AUTH_TYPE_UNSPECIFIED' | 'ISSUER_AUTH_TYPE_IDP' | 'ISSUER_AUTH_TYPE_SELF', enum — This field specifies the authentication mechanism used by the issuer. It determines whether the issuer uses an external Identity Provider (IDP) or a self-issued key for authentication.
  - `proof` Proof — A data integrity proof provides information about the proof mechanism, parameters required to verify that proof, and the proof value itself.
    - `type` string — The type of the proof
    - `proofPurpose` string — The proof purpose
    - `proofValue` string — The proof value

## Response `200`

OK

- RegisterIssuerResponse — Returns a registration response for the issuer

## Other responses

- `default` — Default error response

---

[API](https://skmtc.net/agntcy/apis/identity-node.md) · [All operations](https://skmtc.net/agntcy/apis/identity-node/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agntcy/identity-node/revisions/bf6df0a975b1/schema)