---
title: "Get roam restricted and pending restriction service lines"
method: GET
path: "/public/v2/service-lines/roam-restrictions"
tags: ["Service Lines"]
---

# Get roam restricted and pending restriction service lines

`GET /public/v2/service-lines/roam-restrictions`

## Request

- Base URL: `https://starlink.com/api`
- URL: `https://starlink.com/api/public/v2/service-lines/roam-restrictions`
- Auth: HTTP bearer

Required permission: Service plan, View.

## Query parameters

- `cursor` string

## Response `200`

Roam restrictions retrieved

- PublicServiceLineRoamRestrictionResponseKeyPaginatedStringServiceResponse
  - `errors` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `warnings` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `information` string[], nullable
  - `isValid` boolean
  - `content` PublicServiceLineRoamRestrictionResponseKeyPaginatedString
    - `nextKey` string, nullable: The next key that should be provided to the cursor parameter to fetch the next page, or null if this is the last page.
    - `results` PublicServiceLineRoamRestrictionResponse[]: Results for this page.
      - `serviceLineNumber` string: The service line this status is for. Example: SL-DF-511274-31364-54
      - `status` 'Restricted' | 'Pending'
      - `resolution` PublicRoamRestrictionResolutionResponse
        - `userTerminalId` string: The user terminal this resolution is for. Example: ut01000000-00000000-0000abcd
        - `regionCode` string, nullable: The region the user terminal was most recently located in, which the resolution was based on. Null when there is no location history.
        - `travelAllowanceDaysUsed` integer: Days of data usage counted against the relevant restriction (regulatory limit when in a regulatory restricted region, otherwise the international travel allowance).
        - `internationalTravelAllowanceDays` integer, nullable: The plan's international travel allowance in days. Null means unlimited.
        - `regulatoryRestrictionLimitDays` integer, nullable: The regulatory roaming limit in days for the current region, if it is regulatory restricted.
        - `daysRemaining` integer, nullable: For pending results, the number of days remaining before restriction.

## Other responses

- `401`: Must call as a V2 service account
- `403`: Missing required permission for this endpoint or resource
- `422`: Failed to retrieve roam restrictions

## Changes

- **2026-11-02** `dfd7014cfd6d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/starlink/apis/starlink-management-api/changes/public/v2/service-lines/roam-restrictions/get.md)

---

[API](https://skmtc.dev/starlink/apis/starlink-management-api.md) - [All operations](https://skmtc.dev/starlink/apis/starlink-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starlink/apis/starlink-management-api/revisions/dfd7014cfd6d?raw)