# Juniper Networks Orgs User MACs API

**Canonical:** https://apis.io/apis/juniper/juniper-orgs-user-macs-api/  
**Provider:** Juniper Networks — https://apis.io/providers/juniper/  
**Base URL:** netconf://[device-ip]:830  
**Documentation:** https://www.juniper.net/documentation/product/us/en/junos-pyez/

Juniper Networks Orgs User MACs API is one of 263 APIs that [Juniper Networks](https://apis.io/providers/juniper/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Orgs User MACs. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, a getting-started guide, and rate-limit docs.

NAC User MACs (Endpoints) provide a database of endpoints identified by their MAC addresses. They can be used assign each endpoint with various attributes, such as name, VLAN, role and client label. Once an endpoint is labeled, the label name can be used to create [NAC Tags]($h/Orgs%20NAC%20Tags/_overview) as match criteria. [NAC Tags]($h/Orgs%20NAC%20Tags/_overview) can be used to create Tags regrouping one or multiple endpoint MAC addresses, but the use of the User MACs provides additional features: * possibility to assign specific attributes, like a Name, a RADIUS Group, a VLAN ID, ... * possibility to assign one or multiple Tags (Labels) to a User MAC * improved management for large list of MAC addresses

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/orgs/{org_id}/usermacs` | createOrgUserMac |
| PUT | `/api/v1/orgs/{org_id}/usermacs` | updateOrgMultipleUserMacs |
| GET | `/api/v1/orgs/{org_id}/usermacs/count` | countOrgUserMacs |
| POST | `/api/v1/orgs/{org_id}/usermacs/delete` | deleteOrgMultipleUserMacs |
| POST | `/api/v1/orgs/{org_id}/usermacs/import` | importOrgUserMacs |
| GET | `/api/v1/orgs/{org_id}/usermacs/search` | searchOrgUserMacs |
| DELETE | `/api/v1/orgs/{org_id}/usermacs/{usermac_id}` | deleteOrgUserMac |
| GET | `/api/v1/orgs/{org_id}/usermacs/{usermac_id}` | getOrgUserMac |
| PUT | `/api/v1/orgs/{org_id}/usermacs/{usermac_id}` | updateOrgUserMac |

## Machine-readable artifacts (11)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/juniper/refs/heads/main/openapi/juniper-orgs-user-macs-api-openapi.yml
- **GitHub** — https://github.com/mistsys/mist_openapi
- **APIReference** — https://www.juniper.net/documentation/us/en/software/mist/api/http/guides/overview/overview
- **Documentation** — https://www.juniper.net/documentation/us/en/software/mist/automation-integration/index.html
- **GettingStarted** — https://www.juniper.net/documentation/us/en/software/mist/api/http/getting-started/how-to-get-started
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/juniper/refs/heads/main/asyncapi/juniper-mist-webhooks.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/juniper/refs/heads/main/rate-limits/juniper-rate-limits.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/juniper/refs/heads/main/errors/juniper-problem-types.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/juniper/refs/heads/main/conventions/juniper-conventions.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/juniper/refs/heads/main/data-model/juniper-data-model.yml
- **StatusPage** — https://mist.statuspage.io/

## Other Juniper Networks APIs (12)

- [Junos PyEZ (Python API)](https://apis.io/apis/juniper/junos-pyez-python-api/)
- [JSNAPy API](https://apis.io/apis/juniper/jsnapy-api/)
- [Juniper Networks Allowlists and Blocklists API](https://apis.io/apis/juniper/juniper-allowlists-and-blocklists-api/)
- [Juniper Networks Analytics API](https://apis.io/apis/juniper/juniper-analytics-api/)
- [Juniper Networks Audit Logs API](https://apis.io/apis/juniper/juniper-audit-logs-api/)
- [Juniper Networks Authentication API](https://apis.io/apis/juniper/juniper-authentication-api/)
- [Juniper Networks BGP Routers API](https://apis.io/apis/juniper/juniper-bgp-routers-api/)
- [Juniper Networks Blueprints API](https://apis.io/apis/juniper/juniper-blueprints-api/)
- [Juniper Networks Clients API](https://apis.io/apis/juniper/juniper-clients-api/)
- [Juniper Networks Configlets API](https://apis.io/apis/juniper/juniper-configlets-api/)
- [Juniper Networks Configuration API](https://apis.io/apis/juniper/juniper-configuration-api/)
- [Juniper Networks Connectivity Templates API](https://apis.io/apis/juniper/juniper-connectivity-templates-api/)

## Tags

Orgs User MACs

---

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