Bid Screening

Screen providers by deployment resource requirements

Changed on
post/v1/bid-screening

Request

  • Base URL
    https://console-api-sandbox.akash.network
  • URL
    https://console-api-sandbox.akash.network/v1/bid-screening
  • Auth
    none required

Request body

timezonestring required

Client IANA timezone, validated against zones the runtime recognizes

reclamationWindowinteger

Optional reclamation window in seconds; if provided, only providers with a reclamationWindow greater than or equal to this value will be considered

Example request

{
  "requirements": {
    "attributes": [
      {
        "key": "persistent",
        "value": "false"
      }
    ]
  },
  "resources": [
    {
      "resource": {
        "id": 1,
        "cpu": {
          "attributes": [
            {
              "key": "persistent",
              "value": "false"
            }
          ]
        },
        "memory": {
          "attributes": [
            {
              "key": "persistent",
              "value": "false"
            }
          ]
        },
        "gpu": {
          "attributes": [
            {
              "key": "persistent",
              "value": "false"
            }
          ]
        },
        "storage": [
          {
            "name": "default",
            "attributes": [
              {
                "key": "persistent",
                "value": "false"
              }
            ]
          }
        ]
      },
      "count": 1
    }
  ],
  "timezone": "America/Chicago",
  "reclamationWindow": 3600
}

Response

Returns matching providers

Example response

{
  "providers": [
    {
      "owner": "akash1q7spv2cw06yszgfp4f9ed59lkka6ytn8g4tkjf",
      "hostUri": "https://provider.europlots.com:8443",
      "createdAt": "2026-01-01T00:00:00.000Z",
      "location": "us-west",
      "organization": "Akash",
      "availableGpus": 4,
      "incidents": [
        {
          "date": "2026-06-01"
        }
      ],
      "lastCheckBidAt": "2026-10-18T06:01:30.000Z"
    }
  ]
}

Changes

  • 1b1e84399773Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • b92cd5aa02feRevision changes
    • info

      added the required property // to the response with the status