---
title: "Screen providers by deployment resource requirements"
method: POST
path: "/v1/bid-screening"
tags: ["Bid Screening"]
---

# Screen providers by deployment resource requirements

`POST /v1/bid-screening`

## Request body

- object
  - `name` string, required — Group name
  - `requirements` object
    - `signedBy` object
      - `allOf` string[]
      - `anyOf` string[]
    - `attributes` object[]
      - `key` string, required — Attribute key
      - `value` string, required — Attribute value
  - `resources` object[], required — Resource units with replica counts
    - `resource` object, required
      - `id` integer, required — Resource unit ID
      - `cpu` object, required
        - `units` object, required
          - `val` string, required — String-encoded integer value
        - `attributes` object[], required
          - `key` string, required — Attribute key
          - `value` string, required — Attribute value
      - `memory` object, required
        - `quantity` object, required
          - `val` string, required — String-encoded integer value
        - `attributes` object[], required
          - `key` string, required — Attribute key
          - `value` string, required — Attribute value
      - `gpu` object, required
        - `units` object, required
          - `val` string, required — String-encoded integer value
        - `attributes` object[], required
          - `key` string, required — Attribute key
          - `value` string, required — Attribute value
      - `storage` object[], required
        - `name` string, required — Storage volume name
        - `quantity` object, required
          - `val` string, required — String-encoded integer value
        - `attributes` object[], required
          - `key` string, required — Attribute key
          - `value` string, required — Attribute value
      - `endpoints` unknown[]
        - unknown
    - `count` integer, required — Replica count
    - `price` object, required
      - `denom` string, required
      - `amount` string, required

## Response `200`

Returns matching providers

- object
  - `providers` object[], required
    - `owner` string, required — Provider address
    - `hostUri` string, required — Provider HTTPS endpoint
    - `region` string, nullable, required — Geo-resolved region from IP
    - `uptime7d` number, nullable, required — 7-day uptime as decimal (0.0-1.0)
    - `isAudited` boolean, required — True if signed by a known auditor

## Other responses

- `400` — Invalid request body

## Changes

- **2026-05-07** `967c41f60844` — 14 breaking, 2 warning, 13 info
  - added the new required request property `name`
  - the request property `resources/items/resource/cpu/attributes` became required
  - the request property `resources/items/resource/gpu/attributes` became required
  - the request property `resources/items/resource/memory/attributes` became required
  - …25 more

[Change history](https://skmtc.dev/akash-network/apis/akash-network-console-api/changes/v1/bid-screening/post.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-service-production.skmtc.workers.dev/v1/apis/akash-network/akash-network-console-api/revisions/63b6ade4ec64/schema)