# Nacos Service Discovery API

**Canonical:** https://apis.io/apis/nacos/nacos-service-discovery-api/  
**Provider:** Nacos — https://apis.io/providers/nacos/  
**Base URL:** http://localhost:8848/nacos  
**Documentation:** https://nacos.io/

Nacos Service Discovery API is one of 6 APIs that [Nacos](https://apis.io/providers/nacos/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Service Discovery. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Service instance registration and discovery

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/ns/instance` | Register an instance |
| DELETE | `/v1/ns/instance` | Deregister an instance |
| PUT | `/v1/ns/instance` | Update instance |
| GET | `/v1/ns/instance/list` | List instances |
| PUT | `/v1/ns/instance/beat` | Send instance heartbeat |
| PUT | `/v1/ns/health/instance` | Update instance health status |

## Machine-readable artifacts (2)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/nacos/refs/heads/main/openapi/nacos-service-discovery-api-openapi.yml
- **Documentation** — https://nacos.io/docs/latest/guide/user/open-api/

## Other Nacos APIs (5)

- [Nacos Auth API](https://apis.io/apis/nacos/nacos-auth-api/)
- [Nacos Configuration API](https://apis.io/apis/nacos/nacos-configuration-api/)
- [Nacos Namespace API](https://apis.io/apis/nacos/nacos-namespace-api/)
- [Nacos Operator API](https://apis.io/apis/nacos/nacos-operator-api/)
- [Nacos Service Management API](https://apis.io/apis/nacos/nacos-service-management-api/)

## Tags

Service Discovery

---

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