> For the complete documentation index, see [llms.txt](https://developers.share.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.share.inc/api-reference/demarcation-points.md).

# Demarcation Points

Read-only catalog of demarcation points — the physical/logical edge between the partner network and the subscriber CPE. Only core fields are returned; nested `vlans`, `ipBlocks`, `cpes`, and `radiusInstances` are intentionally hidden from the public surface. DP changes flow through `PATCH /v1/subscriptions/:id`.

## List demarcation points

> Returns the paginated set of demarcation points owned by the authenticated provider. Only core fields are returned; nested resources (VLANs, IP blocks, CPEs, RADIUS instances) are intentionally excluded.

```json
{"openapi":"3.0.0","info":{"title":"Share API","version":"1.0"},"tags":[{"description":"Read-only catalog of demarcation points — the physical/logical edge between the partner network and the subscriber CPE. Only core fields are returned; nested `vlans`, `ipBlocks`, `cpes`, and `radiusInstances` are intentionally hidden from the public surface. DP changes flow through `PATCH /v1/subscriptions/:id`.","name":"Demarcation Points"}],"security":[{"X-Access-Secret":[]},{"X-Access-Id":[]}],"components":{"securitySchemes":{"X-Access-Secret":{"description":"Provider Access Secret Key (JWT)","in":"header","name":"X-Access-Secret","type":"apiKey"},"X-Access-Id":{"description":"Provider Access ID","in":"header","name":"X-Access-Id","type":"apiKey"}},"schemas":{"ApiResponseDto":{"properties":{},"type":"object"},"DemarcationPointResponseDto":{"properties":{"createdAt":{"format":"date-time","type":"string"},"id":{"format":"uuid","type":"string"},"label":{"description":"Operator-supplied label for the demarcation.","type":"string"},"locationId":{"description":"ID of the linked `DemarcationPointLocation` row. `null` when no location has been recorded for this demarcation.","format":"uuid","type":"object"},"nasIp":{"description":"Unique NAS IP that identifies the demarcation point.","type":"string"},"status":{"description":"Operational status of the demarcation point.","enum":["ACTIVE","MAINTENANCE","OFFLINE"],"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","label","nasIp","createdAt","updatedAt"],"type":"object"}}},"paths":{"/v1/demarcation-points":{"get":{"description":"Returns the paginated set of demarcation points owned by the authenticated provider. Only core fields are returned; nested resources (VLANs, IP blocks, CPEs, RADIUS instances) are intentionally excluded.","operationId":"DemarcationPointsController_listDemarcationPoints_v1","parameters":[{"description":"Page number (1-based).","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"type":"number"}},{"description":"Number of items per page.","in":"query","name":"limit","required":false,"schema":{"default":20,"maximum":100,"minimum":1,"type":"number"}},{"description":"Restrict results to demarcation points in the given status.","in":"query","name":"status","required":false,"schema":{"enum":["ACTIVE","MAINTENANCE","OFFLINE"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ApiResponseDto"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/DemarcationPointResponseDto"},"type":"array"},"success":{"type":"boolean"}}}]}}},"description":"Paginated list of demarcation points."},"400":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"string"},"rejectionReasons":{"items":{"properties":{"code":{"type":"string"},"field":{"type":"string"},"message":{"type":"string"}},"type":"object"},"type":"array"},"success":{"type":"boolean"}}}}},"description":"Validation failed"},"401":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"string"},"success":{"type":"boolean"}}}}},"description":"Unauthorized — missing or invalid credentials"},"403":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"string"},"success":{"type":"boolean"}}}}},"description":"Forbidden — insufficient permissions"},"404":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"string"},"success":{"type":"boolean"}}}}},"description":"Resource not found"},"408":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"string"},"success":{"type":"boolean"}}}}},"description":"Request timeout"},"500":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"string"},"success":{"type":"boolean"}}}}},"description":"Internal server error"}},"summary":"List demarcation points","tags":["Demarcation Points"]}}}}
```

## Get a demarcation point

> Returns a single demarcation point owned by the authenticated provider. Returns 404 for identifiers belonging to a different provider — cross-provider identifiers are not leaked.

```json
{"openapi":"3.0.0","info":{"title":"Share API","version":"1.0"},"tags":[{"description":"Read-only catalog of demarcation points — the physical/logical edge between the partner network and the subscriber CPE. Only core fields are returned; nested `vlans`, `ipBlocks`, `cpes`, and `radiusInstances` are intentionally hidden from the public surface. DP changes flow through `PATCH /v1/subscriptions/:id`.","name":"Demarcation Points"}],"security":[{"X-Access-Secret":[]},{"X-Access-Id":[]}],"components":{"securitySchemes":{"X-Access-Secret":{"description":"Provider Access Secret Key (JWT)","in":"header","name":"X-Access-Secret","type":"apiKey"},"X-Access-Id":{"description":"Provider Access ID","in":"header","name":"X-Access-Id","type":"apiKey"}},"schemas":{"ApiResponseDto":{"properties":{},"type":"object"},"DemarcationPointResponseDto":{"properties":{"createdAt":{"format":"date-time","type":"string"},"id":{"format":"uuid","type":"string"},"label":{"description":"Operator-supplied label for the demarcation.","type":"string"},"locationId":{"description":"ID of the linked `DemarcationPointLocation` row. `null` when no location has been recorded for this demarcation.","format":"uuid","type":"object"},"nasIp":{"description":"Unique NAS IP that identifies the demarcation point.","type":"string"},"status":{"description":"Operational status of the demarcation point.","enum":["ACTIVE","MAINTENANCE","OFFLINE"],"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","label","nasIp","createdAt","updatedAt"],"type":"object"}}},"paths":{"/v1/demarcation-points/{id}":{"get":{"description":"Returns a single demarcation point owned by the authenticated provider. Returns 404 for identifiers belonging to a different provider — cross-provider identifiers are not leaked.","operationId":"DemarcationPointsController_getDemarcationPoint_v1","parameters":[{"description":"Demarcation point identifier (UUID).","in":"path","name":"id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ApiResponseDto"},{"properties":{"data":{"$ref":"#/components/schemas/DemarcationPointResponseDto"},"success":{"type":"boolean"}}}]}}},"description":"The requested demarcation point."},"400":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"string"},"rejectionReasons":{"items":{"properties":{"code":{"type":"string"},"field":{"type":"string"},"message":{"type":"string"}},"type":"object"},"type":"array"},"success":{"type":"boolean"}}}}},"description":"Validation failed"},"401":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"string"},"success":{"type":"boolean"}}}}},"description":"Unauthorized — missing or invalid credentials"},"403":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"string"},"success":{"type":"boolean"}}}}},"description":"Forbidden — insufficient permissions"},"404":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"string"},"success":{"type":"boolean"}}}}},"description":"Resource not found"},"408":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"string"},"success":{"type":"boolean"}}}}},"description":"Request timeout"},"500":{"content":{"application/json":{"schema":{"properties":{"error":{"type":"string"},"success":{"type":"boolean"}}}}},"description":"Internal server error"}},"summary":"Get a demarcation point","tags":["Demarcation Points"]}}}}
```