---
title: "Search Mobile Availability"
method: GET
path: "/public/user/mobile_availability/search"
tags: ["Mobile Availability"]
---

# Search Mobile Availability

`GET /public/user/mobile_availability/search`

Search mobile availability records with optional grouping capabilities.
Use `group_by` parameter to aggregate results by specified field(s).

## Query parameters

- `country_id` string
- `subdivision_id` string
- `city_name` string
- `asn_id` integer
- `zip_code_alias` string
- `mobile_availability_node_count` integer
- `group_by` 'country' | 'subdivision' | 'city' | 'asn' | 'zip_code'
- `sort_by` string

## Response `200`

Search mobile node count successful

- object
  - `data` object
    - `mobile_options` object[]
      - `asn_id` integer — Filter by Autonomous System Number
      - `city_name` string — Filter by city name
      - `country_id` string — Filter by 2-character country code
      - `mobile_availability_node_count` integer — Filter by node count
      - `subdivision_id` string — Filter by state/province identifier
      - `zip_code_alias` string — Filter by postal/ZIP code
    - `total_mobile_availability_node_count` integer — Total number of nodes available for given filter parameters
  - `message` string

---

[API](https://skmtc.dev/byteful/apis/byteful-public-user-api.md) · [All operations](https://skmtc.dev/byteful/apis/byteful-public-user-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/byteful/byteful-public-user-api/revisions/3db1a6fc0099/schema)