Skip to main content
POST
/
v1
/
issuer-applications
Create issuer application
curl --request POST \
  --url https://api.truthlocks.com/v1/issuer-applications \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "legal_name": "<string>",
  "display_name": "<string>",
  "jurisdiction": "<string>",
  "registration_ref": "<string>",
  "contact_name": "<string>",
  "contact_email": "<string>",
  "org_id": "<string>"
}
'
{
  "id": "<string>",
  "legal_name": "<string>",
  "status": "<string>",
  "created_at": "<string>"
}
Creates a new issuer application for your organization. The application starts in DRAFT status, allowing you to upload evidence before submitting for review. See the issuer application guide for a walkthrough of the full application workflow.

​
Parameters

​
legal_name
string
required
Full registered legal name of the organization applying to become an issuer.
​
display_name
string
Name shown on credentials and proof pages. Defaults to legal_name if omitted.
​
jurisdiction
string
Country or region where the organization is registered (for example, "United States" or "United Kingdom").
​
registration_ref
string
Company registration or incorporation number.
​
requested_trust_tier
string
Trust tier you are applying for. Defaults to "verified_org" if omitted. Accepted values: verified_org, government_entity, accredited_institution.
​
contact_name
string
Name of the primary contact for this application.
​
contact_email
string
Email address of the primary contact.
​
org_id
uuid
Organization to associate the application with. If omitted, the application is linked to your tenant’s default organization.

​
Responses

Authorizations

​
X-API-Key
string
header
required

API key for machine-to-machine authentication

Body

application/json
​
legal_name
string
required
​
display_name
string
​
jurisdiction
string
​
registration_ref
string
​
requested_trust_tier
enum<string>
Available options:
verified_org,
government_entity,
accredited_institution
​
contact_name
string
​
contact_email
string
​
org_id
string

Response

Application created

​
id
string
​
legal_name
string
​
status
string
​
created_at
string