---
title: "Search"
method: POST
path: "/as/search"
tags: ["Autonomous Systems"]
---

# Search

`POST /as/search`

Returns a list of autonomous systems that matched the search query. Allows getting only the first 10,000 results. To get more results please use scroll or download API endpoints. By default, search operations, which return a list of found items, return only the first 25 items. To get a different set of items, you can use the offset and limit parameters in the request body.

## Request body

- SearchASRequest
  - `limit` integer — The maximum number of items to return per page. Value must be in the range between 1 and 100.
  - `offset` integer — The offset of the item at which to begin the response. Value must be in the range between 1 and 9999.
  - `search_params` object[], required — A list of AS attributes to filter the search results by. A comprehensive list of valid search parameters is shown in the table below.

## Response `200`

Operation successful

- ASListResponse
  - `data` ASListResponseData
    - `limit` integer — The limit used for this page of results. This will be the same as the `limit` query parameter unless it exceeded the maximum value allowed for this API endpoint.
    - `offset` integer — The offset used for this page of results. The paging is limited to the first 10,000 results for performance. To get more results please use scroll or download API endpoints.
    - `total_items` integer — The number of found matches. The value is limited to 10,000 for performance reasons. To get a precise count number please use the count API endpoint.
    - `items` AS[]
      - `as_org` string — The name of organization that is associated with the autonomous system.
      - `asn` integer — The number of the autonomous system.
      - `ipv4_prefixes` IPV4Prefix[] — The list of IPv4 prefixes that belong to this autonomous system.
        - `cidr` string
        - `domains_count` integer
        - `isp` string
      - `ipv4_prefixes_updated_at` string, date-time
      - `ipv6_prefixes` IPV6Prefix[] — The list of IPv6 prefixes that belong to this autonomous system.
        - `cidr` string
        - `isp` string
      - `ipv6_prefixes_updated_at` string, date-time
      - `updated_at` string, date-time

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.dev/spyse/apis/data-api.md) · [All operations](https://skmtc.dev/spyse/apis/data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spyse/data-api/revisions/fd05b83ed2c5/schema)