i9Networki9developers
All APIs

i9Network Subscribers API

v1

Manage ISP subscribers — onboarding, lookup, and lifecycle. Authenticate with a bearer token; test against the sandbox before requesting production access.

Sandbox base URL

https://sandbox-api.i9network.com

Production base URL

https://api.i9network.com

Subscribers

Create and manage subscriber records.

GET/v1/subscribers

List subscribers

bearerAuth: subscribers:read

Sandbox: https://sandbox-api.i9network.com/v1/subscribers

Production: https://api.i9network.com/v1/subscribers

Query parameters

  • limitinteger

    Max results per page (1-100).

  • cursorstring

    Pagination cursor.

Responses

  • 200A page of subscribers.
curl -X GET "https://sandbox-api.i9network.com/v1/subscribers" \
  -H "Authorization: Bearer $I9_SANDBOX_TOKEN"
Example response · 200
{
  "data": [
    {
      "id": "sub_12345",
      "name": "Acme Broadband",
      "email": "ops@acme.net",
      "plan_id": "plan_fiber_100",
      "status": "active",
      "created_at": "2024-10-01T12:00:00Z"
    }
  ],
  "next_cursor": "string"
}
Try in sandbox
Requests run only against https://sandbox-api.i9network.com — never production.

Query parameters

POST/v1/subscribers

Create a subscriber

Onboard a new subscriber. Idempotent via the Idempotency-Key header.

bearerAuth: subscribers:write

Sandbox: https://sandbox-api.i9network.com/v1/subscribers

Production: https://api.i9network.com/v1/subscribers

Headers

  • Idempotency-Keystring

    Unique key to safely retry the request.

Responses

  • 201Subscriber created.
  • 400Invalid request body.
  • 401Missing or invalid credentials.
  • 429Rate limit exceeded.
curl -X POST "https://sandbox-api.i9network.com/v1/subscribers" \
  -H "Authorization: Bearer $I9_SANDBOX_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Acme Broadband",
  "email": "ops@acme.net",
  "plan_id": "plan_fiber_100",
  "status": "active"
}'
Example response · 201
{
  "id": "sub_12345",
  "name": "Acme Broadband",
  "email": "ops@acme.net",
  "plan_id": "plan_fiber_100",
  "status": "active",
  "created_at": "2024-10-01T12:00:00Z"
}
Try in sandbox
Requests run only against https://sandbox-api.i9network.com — never production.

Headers

Request body

GET/v1/subscribers/{id}

Get a subscriber

bearerAuth: subscribers:read

Sandbox: https://sandbox-api.i9network.com/v1/subscribers/{id}

Production: https://api.i9network.com/v1/subscribers/{id}

Path parameters

  • idrequiredstring

    Subscriber identifier.

Responses

  • 200The subscriber.
  • 404Subscriber not found.
curl -X GET "https://sandbox-api.i9network.com/v1/subscribers/{id}" \
  -H "Authorization: Bearer $I9_SANDBOX_TOKEN"
Example response · 200
{
  "id": "sub_12345",
  "name": "Acme Broadband",
  "email": "ops@acme.net",
  "plan_id": "plan_fiber_100",
  "status": "active",
  "created_at": "2024-10-01T12:00:00Z"
}
Try in sandbox
Requests run only against https://sandbox-api.i9network.com — never production.

Path parameters