---
title: "Get all service lines"
method: GET
path: "/public/v2/service-lines"
tags: ["Service Lines"]
---

# Get all service lines

`GET /public/v2/service-lines`

Required permission: Service plan, View.

## Query parameters

- `addressReferenceId` string, uuid
- `searchString` string
- `dataPoolId` string
- `page` integer
- `orderByCreatedDateDescending` boolean

## Response `200`

Service lines retrieved

- ServiceLineResponsePaginatedServiceResponse
  - `errors` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `warnings` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `information` string[], nullable
  - `isValid` boolean
  - `content` ServiceLineResponsePaginated
    - `pageIndex` integer
    - `limit` integer
    - `isLastPage` boolean
    - `results` ServiceLineResponse[], nullable
      - `addressReferenceId` string, uuid — Address Reference ID of the address associated with the service line. Example: 55ec6574-10d8-bd9c-1951-d4184f4ae467
      - `serviceLineNumber` string — The Service Line Number. Example: AST-511274-31364-54
      - `nickname` string, nullable — A user-defined nickname for this service line.
      - `productReferenceId` string — The unique product identifier.
      - `delayedProductId` string, nullable — Scheduled product change for next bill date.
      - `optInProductId` string, nullable — Opt-in product id, opted out if empty.
      - `startDate` string, date-time, nullable — The start date of the subscription. This is in UTC.
      - `endDate` string, date-time, nullable — The service line deactivation date, which only appears if the service line is deactivated. This is in UTC.
      - `publicIp` boolean — Indicates if service line is public IP.
      - `active` boolean — Indicates if service line is active.
      - `aviationMetadata` AviationMetadataResponse
        - `tailNumber` string, nullable
        - `seatCount` integer
        - `airlineIataCode` string, nullable
        - `aircraftIataCode` string, nullable
        - `airlineIcaoCode` string, nullable
        - `aircraftIcaoCode` string, nullable
        - `stcNumber` string, nullable
      - `dataBlocks` ServiceLineDataBlocksSummaryResponse
        - `recurringBlocksCurrentBillingCycle` DataBlockSummaryResponse[], nullable — The current billing cycle's monthly recurring data blocks.
          - `productId` string, nullable — The block's product id.
          - `startDate` string, date-time — The block's start date.
          - `expirationDate` string, date-time — The block's end date.
          - `count` integer — How many blocks of this type there are.
          - `dataAmount` number, double — The data amount of each block.
          - `dataUnitType` string, nullable — The unit that the data amount is in.
        - `recurringBlocksNextBillingCycle` DataBlockSummaryResponse[], nullable — Next billing cycle's monthly recurring data blocks.
          - `productId` string, nullable — The block's product id.
          - `startDate` string, date-time — The block's start date.
          - `expirationDate` string, date-time — The block's end date.
          - `count` integer — How many blocks of this type there are.
          - `dataAmount` number, double — The data amount of each block.
          - `dataUnitType` string, nullable — The unit that the data amount is in.
        - `delayedProductRecurringBlocksNextCycle` DataBlockSummaryResponse[], nullable — What recurring blocks will be when the service line switches to the delayed product.
          - `productId` string, nullable — The block's product id.
          - `startDate` string, date-time — The block's start date.
          - `expirationDate` string, date-time — The block's end date.
          - `count` integer — How many blocks of this type there are.
          - `dataAmount` number, double — The data amount of each block.
          - `dataUnitType` string, nullable — The unit that the data amount is in.
        - `topUpBlocksOptInPurchase` DataBlockSummaryResponse[], nullable — What top up blocks were automatically purchased because the service line was out of data and opted in.
          - `productId` string, nullable — The block's product id.
          - `startDate` string, date-time — The block's start date.
          - `expirationDate` string, date-time — The block's end date.
          - `count` integer — How many blocks of this type there are.
          - `dataAmount` number, double — The data amount of each block.
          - `dataUnitType` string, nullable — The unit that the data amount is in.
        - `topUpBlocksOneTimePurchase` DataBlockSummaryResponse[], nullable — What top up blocks were manually purchased.
          - `productId` string, nullable — The block's product id.
          - `startDate` string, date-time — The block's start date.
          - `expirationDate` string, date-time — The block's end date.
          - `count` integer — How many blocks of this type there are.
          - `dataAmount` number, double — The data amount of each block.
          - `dataUnitType` string, nullable — The unit that the data amount is in.
    - `totalCount` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden from retrieving service lines for this account
- `422` — Failed to retrieve service lines

---

[API](https://skmtc.net/starlink/apis/starlink-management-api.md) · [All operations](https://skmtc.net/starlink/apis/starlink-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/starlink/starlink-management-api/revisions/a730bd0ddb42/schema)