List objects

Retrieve a paginated list of smart objects accessible to the authenticated user. 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
/objects

Authorization

AuthorizationBearer <token>

In: header

Query Parameters

id?string

Filter resources by their unique identifier

org_id?string

Filter resources by the organization they belong to

autocomplete?string

Search term for autocomplete functionality

limit?integer

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

Formatint64
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

fqdn?string

Filter objects by fully qualified domain name

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[$gte]?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[$lte]?string
Formatdate-time
when_modified[$gt]?string
Formatdate-time
when_modified[$lt]?string
Formatdate-time
when_modified[$gte]?string
Formatdate-time
when_modified[$lte]?string
Formatdate-time

Response Body

application/json

application/json

application/json

curl -X GET "https://api-testnet.dual.network/objects"
{
  "objects": [
    {
      "id": "string",
      "org_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
      },
      "assets": [
        {
          "id": "string",
          "name": "string",
          "type": "string",
          "url": "string",
          "hash": "string",
          "is_public": true,
          "when_created": "2019-08-24T14:15:22Z"
        }
      ],
      "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": {}
}