Get all Instances, Public

This is a public route and can be accessed by anyone.

Get All Public Instances

This endpoint provides a public, unauthenticated method to retrieve a list of all active instances available on the marketplace. This is ideal for populating public-facing websites, dashboards, or for any application that needs to display the full catalog of offerings.

Endpoint

HTTP

GET /api/v1/public/instances

Authentication

Type	Required	Description
None	false	This is a public endpoint and requires no API key.

Rate Limiting

To ensure fair usage and protect the service from abuse, this endpoint is rate-limited.

• Limit: 50 requests per IP address per minute.
• Exceeding the limit: If you exceed this rate, the API will respond with an HTTP 429 Too Many Requests error until the one-minute window resets.

📘

For unlimited public instance endpoint access, email us at [email protected]

---

Request

This endpoint does not require a request body or any URL parameters.

Example Request

Here is an example of how to call this public endpoint using cURL.

Bash

curl -X GET 'https://offers.dataoorts.com/api/v1/public/instances'

---

Responses

✅ Success Response (200 OK)

A successful request will return an HTTP 200 OK status code and a JSON array of instance objects. The structure of each object is the same as the one defined in the Create an Instance endpoint documentation.

Body

JSON

[
  {
    "_id": "IID_21052024103005123",
    "pro_id": "PRO_15052024120000123",
    "gpu_model": "NVIDIA A100 80GB",
    "is_featured": true,
    "interconnect_details": "NVLink 600 GB/s",
    "total_gpus": "8",
    "os": "Ubuntu 22.04 LTS",
    "cpu": "2 x AMD EPYC 7742",
    "ram": "1024GB DDR4",
    "storage": "4TB NVMe SSD",
    "network_and_bandwidth_details": "200 Gbps Infiniband",
    "location": "Mumbai, India",
    "support_options": "Email & Phone Support 24/7",
    "instance_backing": "Secured",
    "instance_type": "Bare Metal",
    "additional_details": "This is a high-performance instance for AI training.",
    "created_at_ist": "2024-05-21T10:30:05.123Z",
    "pricing": {
      "1m": {
        "original": 5000.00,
        "offered": 4899.99
      },
      "3m": {
        "original": 14500.00,
        "offered": 13999.50
      }
    },
    "time_extension_details": {
      "allowed": true,
      "at_same_cost": false
    }
  },
  {
    "...another instance object..."
  }
]

Note: This one is just an example the actual response will contain all instance objects in the database.

❌ Error Response (429 Too Many Requests)

This response is returned if the client's IP address has exceeded the rate limit of 50 requests per minute.

Body

JSON

{
  "error": "Rate limit exceeded. Please try again later."
}

❌ Error Response (500 Internal Server Error)

This response indicates a problem on the server, such as a database connection error.

Body

JSON

{
  "error": "A database error occurred",
  "details": "Specific error message from the database driver."
}