Returns milestones based on given query parameters.

GET 
/api/explorer/v2/milestones

Returns a list of milestones matching provided query parameters.

Request

Query Parameters

startTimestamp integer
Start timestamp for filtering.
Example: 1662139730
endTimestamp integer
End timestamp for filtering.
Example: 1662139830
sort string
Describes the sort order, either by oldest or newest. This value is NOT overridden by the cursor, and thus can be used to back-page.
Example: newest
pageSize number
Requested page size. Overridden by the cursor if provided.
Example: 100
cursor string
The cursor which can be used to retrieve the next logical page of results.
Example: 1643383242.fa0de75d225cca2799395e5fc340702fc7eac821d2bdd79911126f131ae097a20100.100

Responses

200

Successful operation.

application/json

Schema

Schema

items undefined[]required
A list of milestones.
Array [
milestoneId stringrequired
The milestone ID.
index integerrequired
The index of the milestone.
]
cursor string

The cursor which can be used to retrieve the next logical page of results.

Example (from schema)

{
  "items": [
    {
      "milestoneId": "string",
      "index": 0
    }
  ],
  "cursor": "string"
}

default

{
  "items": [
    {
      "milestoneId": "0x7a09324557e9200f39bf493fc8fd6ac43e9ca750c6f6d884cc72386ddcb7d695",
      "index": 100
    },
    {
      "milestoneId": "0xfa0de75d225cca2799395e5fc340702fc7eac821d2bdd79911126f131ae097a2",
      "index": 101
    }
  ],
  "cursor": "102.2"
}

400

Unsuccessful operation: indicates that the provided parameters are invalid.

application/json

Schema

Schema

error objectrequired

code stringrequired

The application error code.

message stringrequired

The error reason.

Example (from schema)

{
  "error": {
    "code": 400,
    "message": "invalid data provided"
  }
}

404

Unsuccessful operation: indicates that the requested data was not found.

application/json

Schema

Schema

error objectrequired

code stringrequired

The application error code.

message stringrequired

The error reason.

Example (from schema)

{
  "error": {
    "code": 404,
    "message": "could not find data"
  }
}

500

Unsuccessful operation: indicates that an unexpected, internal server error happened which prevented the node from fulfilling the request.

application/json

Schema

Schema

error objectrequired

code stringrequired

The application error code.

message stringrequired

The error reason.

Example (from schema)

{
  "error": {
    "code": 500,
    "message": "internal server error"
  }
}

Loading...