# X-Road (NIIS) Token Certificates API

**Canonical:** https://apis.io/apis/x-road-global/x-road-global-token-certificates-api/  
**Provider:** X-Road (NIIS) — https://apis.io/providers/x-road-global/  
**Base URL:** https://{security-server-host}:4000/api/v1  
**Documentation:** https://docs.x-road.global/

X-Road (NIIS) Token Certificates API is one of 40 APIs that [X-Road (NIIS)](https://apis.io/providers/x-road-global/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 2 JSON Schema definitions. Tagged areas include Token Certificates. The published artifact set on APIs.io includes an OpenAPI specification and 2 JSON Schemas.

The token-certificates API from X-Road (NIIS) — 9 operation(s) for token-certificates.

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| POST | `/token-certificates` | import new certificate |
| GET | `/token-certificates/{hash}` | get certificate information |
| DELETE | `/token-certificates/{hash}` | delete certificate |
| PUT | `/token-certificates/{hash}/activate` | activate certificate |
| PUT | `/token-certificates/{hash}/disable` | deactivate certificate |
| POST | `/token-certificates/{hash}/import` | import an existing certificate from a token by cert hash |
| GET | `/token-certificates/{hash}/possible-actions` | get possible actions for one certificate |
| PUT | `/token-certificates/{hash}/register` | register certificate |
| PUT | `/token-certificates/{hash}/unregister` | unregister authentication certificate |
| PUT | `/token-certificates/{hash}/mark-for-deletion` | marks an auth certificate for deletion |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/x-road-global/openapi/x-road-global-token-certificates-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/x-road-global/json-schema/x-road-global-certificate-details-schema.json
- **JSONSchema** — https://artifacts.apis.io/x-road-global/json-schema/x-road-global-token-certificate-schema.json

## Other X-Road (NIIS) APIs (12)

- [X-Road Management Services (SOAP)](https://apis.io/apis/x-road-global/management-services/)
- [X-Road Environmental and Operational Monitoring (SOAP)](https://apis.io/apis/x-road-global/monitoring/)
- [X-Road (NIIS) Backups API](https://apis.io/apis/x-road-global/x-road-global-backups-api/)
- [X-Road (NIIS) Certificate Authorities API](https://apis.io/apis/x-road-global/x-road-global-certificate-authorities-api/)
- [X-Road (NIIS) Certification Services API](https://apis.io/apis/x-road-global/x-road-global-certification-services-api/)
- [X-Road (NIIS) Clients API](https://apis.io/apis/x-road-global/x-road-global-clients-api/)
- [X-Road (NIIS) Configuration Parts API](https://apis.io/apis/x-road-global/x-road-global-configuration-parts-api/)
- [X-Road (NIIS) Configuration Source Anchors API](https://apis.io/apis/x-road-global/x-road-global-configuration-source-anchors-api/)
- [X-Road (NIIS) Configuration Sources API](https://apis.io/apis/x-road-global/x-road-global-configuration-sources-api/)
- [X-Road (NIIS) Dataspace API](https://apis.io/apis/x-road-global/x-road-global-dataspace-api/)
- [X-Road (NIIS) Diagnostics API](https://apis.io/apis/x-road-global/x-road-global-diagnostics-api/)
- [X-Road (NIIS) Ds Tls Certification Authorities API](https://apis.io/apis/x-road-global/x-road-global-ds-tls-certification-authorities-api/)

## Tags

Token Certificates

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/x-road-global/x-road-global-token-certificates-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/x-road-global/.