---
title: "Search providers, one page at a time."
method: GET
path: "/v1/provider-search"
tags: ["Providers"]
---

# Search providers, one page at a time.

`GET /v1/provider-search`

## Request

- Base URL: `https://console-api-sandbox.akash.network`
- URL: `https://console-api-sandbox.akash.network/v1/provider-search`
- Auth: none required

Filters and sorts every provider on the network, then answers the requested page along with how many providers matched.

## Query parameters

- `search` string: Case-insensitive substring matched against each provider's host URI and address.
- `online` 'true' | 'false': Only online providers when true, only offline ones when false, both when omitted.
- `audited` 'true' | 'false': Only audited providers when true, only unaudited ones when false, both when omitted.
- `addresses` string: Comma-separated provider addresses the search is limited to, at most 100.
- `regions` string: Comma-separated location-region attribute values, at most 50. Keeps providers in any of them.
- `gpu` 'true' | 'false': Only providers with GPUs when true, only providers without any when false, both when omitted.
- `gpuModels` string: Comma-separated GPU model names, matched ignoring case, at most 50. Keeps providers with any of them.
- `sort` 'active-leases-desc' | 'active-leases-asc' | 'wallet-leases-desc' | 'wallet-active-leases-desc' | 'gpus-desc': `active-leases-*` orders by the provider's active lease count, `wallet-leases-desc` and `wallet-active-leases-desc` by how many leases `walletAddress` holds on it, and `gpus-desc` by its GPU count across available, pending and active ones.
- `walletAddress` string: The wallet whose leases the `wallet-leases-desc` and `wallet-active-leases-desc` sorts count. Required by those sorts.
- `skip` integer, nullable: Matching providers to skip before the page begins.
- `limit` integer: Providers per page, at most 100.

## Response `200`

Returns a page of the providers matching the search

- object
  - `data` object, required
    - `providers` object[], required
      - `owner` string, required
      - `name` string, nullable, required
      - `hostUri` string, required
      - `createdHeight` number, required
      - `email` string, nullable
      - `website` string, nullable
      - `lastCheckDate` string, nullable
      - `deploymentCount` number, nullable
      - `leaseCount` number, nullable
      - `cosmosSdkVersion` string, required
      - `akashVersion` string, required
      - `ipRegion` string, nullable, required
      - `ipRegionCode` string, nullable, required
      - `ipCountry` string, nullable, required
      - `ipCountryCode` string, nullable, required
      - `ipLat` string, nullable, required
      - `ipLon` string, nullable, required
      - `uptime1d` number, nullable, required
      - `uptime7d` number, nullable, required
      - `uptime30d` number, nullable, required
      - `isValidVersion` boolean, required
      - `isOnline` boolean, required
      - `lastOnlineDate` string, nullable, required
      - `isAudited` boolean, required
      - `stats` object, required
        - `cpu` object, required
          - `active` number, required
          - `available` number, required
          - `pending` number, required
        - `gpu` object, required
          - `active` number, required
          - `available` number, required
          - `pending` number, required
        - `memory` object, required
          - `active` number, required
          - `available` number, required
          - `pending` number, required
        - `storage` object, required
          - `ephemeral` object, required
            - `active` number, required
            - `available` number, required
            - `pending` number, required
          - `persistent` object, required
            - `active` number, required
            - `available` number, required
            - `pending` number, required
      - `gpuModels` object[], required
        - `vendor` string, required
        - `model` string, required
        - `ram` string, required
        - `interface` string, required
      - `attributes` object[], required
        - `key` string, required
        - `value` string, required
        - `auditedBy` string[], required
      - `host` string, nullable, required
      - `organization` string, nullable, required
      - `statusPage` string, nullable, required
      - `locationRegion` string, nullable, required
      - `country` string, nullable, required
      - `city` string, nullable, required
      - `timezone` string, nullable, required
      - `locationType` string, nullable, required
      - `hostingProvider` string, nullable, required
      - `hardwareCpu` string, nullable, required
      - `hardwareCpuArch` string, nullable, required
      - `hardwareGpuVendor` string, nullable, required
      - `hardwareGpuModels` string[], nullable, required
      - `hardwareDisk` string[], nullable, required
      - `featPersistentStorage` boolean, required
      - `featPersistentStorageType` string[], nullable, required
      - `hardwareMemory` string, nullable, required
      - `networkProvider` string, nullable, required
      - `networkSpeedDown` number, required
      - `networkSpeedUp` number, required
      - `tier` string, nullable, required
      - `featEndpointCustomDomain` boolean, required
      - `workloadSupportChia` boolean, required
      - `workloadSupportChiaCapabilities` string[], nullable, required
      - `featEndpointIp` boolean, required
    - `pagination` object, required
      - `total` number, required: Providers matching the filters.
      - `skip` number, required
      - `limit` number, required
      - `hasMore` boolean, required: Whether a further page exists.

## Other responses

- `400`: Invalid search parameters

## Changes

- **2026-10-08** `6e692543f55c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/akash-network/apis/akash-network-console-api/changes/v1/provider-search/get.md)

---

[API](https://skmtc.dev/akash-network/apis/akash-network-console-api.md) - [All operations](https://skmtc.dev/akash-network/apis/akash-network-console-api/llms.txt) - [OpenAPI document](https://skmtc.dev/akash-network/apis/akash-network-console-api/revisions/b959efa6d493?raw)