v16

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-0112316797.5 KB

Bid Screening

Screen providers by deployment resource requirements

post/v1/bid-screening

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",
      "incidents": [
        {
          "date": "2026-06-01"
        }
      ]
    }
  ]
}