# X-Road (NIIS) Services API

**Canonical:** https://apis.io/apis/x-road-global/x-road-global-services-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) Services 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 1 JSON Schema definition. Tagged areas include Services. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

services endpoints

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/services/{id}` | get service |
| PATCH | `/services/{id}` | update service |
| POST | `/services/{id}/endpoints` | create endpoint |
| GET | `/services/{id}/service-clients` | get service clients who have access rights for the selected service |
| POST | `/services/{id}/service-clients` | add access rights to selected service for new ServiceClients |
| POST | `/services/{id}/service-clients/delete` | remove access to selected service from given ServiceClients |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/x-road-global/openapi/x-road-global-services-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/x-road-global/json-schema/x-road-global-service-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

Services

---

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