List Objects Public

Retrieve a paginated list of smart objects accessible to the public. This endpoint supports comprehensive filtering by various criteria including object type, ownership, location, template associations, and temporal ranges. Objects can be filtered by faces, actions, ownership, geographical location, and creation/modification timestamps.

GET
/public/objects

Query Parameters

id?string

Filter resources by their unique identifier

limit?integer

How many items to return at one time (max 100)

Formatint64
autocomplete?string

Search term for autocomplete functionality

next?string

Pagination token for retrieving the next page of results

order?string

Sort order for the results (ascending or descending)

Value in"asc" | "desc"
sortBy?string

Field name to sort the results by

faces?boolean

Optional flag for face objects

actions?boolean

Optional flag for action objects

owner?string

Filter by the owner's address

dropped?boolean

Optional flag for dropped items

geo_hash?string

Geographical hash for location-based filtering

template_id?string

Filter by the collection ID

when_created[$gt]?string

Filter objects created after this date and time

Formatdate-time
when_created[$lt]?string

Filter objects created before this date and time

Formatdate-time
when_created[$gte]?string

Filter objects created on or after this date and time

Formatdate-time
when_created[$lte]?string

Filter objects created on or before this date and time

Formatdate-time
when_modified[$gt]?string

Filter objects modified after this date and time

Formatdate-time
when_modified[$lt]?string

Filter objects modified before this date and time

Formatdate-time
when_modified[$gte]?string

Filter objects modified on or after this date and time

Formatdate-time
when_modified[$lte]?string

Filter objects modified on or before this date and time

Formatdate-time

Response Body

application/json

application/json

application/json

curl -X GET "https://api-testnet.dual.network/public/objects"
{
  "objects": [
    {
      "id": "string",
      "chain": {
        "ownership_claimed": true
      },
      "custom": {},
      "custom_hash": "string",
      "metadata": {
        "name": "string",
        "description": "string",
        "category": "string",
        "image": {
          "id": "string",
          "name": "string",
          "type": "string",
          "url": "string",
          "hash": "string",
          "is_public": true,
          "when_created": "2019-08-24T14:15:22Z"
        },
        "edition": 0
      },
      "owner": "string",
      "template_id": "string",
      "location": {
        "latitude": 0.1,
        "longitude": 0.1,
        "geo_hash": "string"
      },
      "nonce": 0,
      "version": 0,
      "state_hash": "string",
      "content_hash": "string",
      "integrity_hash": "string",
      "prev_integrity_hash": "string",
      "when_created": "2019-08-24T14:15:22Z",
      "when_modified": "2019-08-24T14:15:22Z"
    }
  ],
  "faces": [
    {
      "template_id": "string",
      "face": {
        "id": "string",
        "url": "string",
        "config": {},
        "content": "string"
      }
    }
  ],
  "actions": [
    {
      "template_id": "string",
      "actions": [
        "string"
      ]
    }
  ],
  "next": "string"
}
{
  "code": 0,
  "message": "string",
  "details": {}
}
{
  "code": 0,
  "message": "string",
  "details": {}
}