POST /chains/search

This endpoint allows you to search among user's chains by one or multiple external IDs.

post
Search user's chains by extIds

http://localhost:8081/v1/chains/search
Important! `content` and `extIds` are sent and received into Base64 format. Open API SDKs automatically convert the data into Base64.
Request
Response
Query Parameters
start
optional
integer
Select item you would like to start. E.g. if you've already seen 30 items and want to see next 30, then you will provide `start=30`. Default: 0
limit
optional
integer
The number of items you would like back in each page. Default: 30
status
optional
string
Filter results by chain's status. One of: queue, processing, completed By default filtering disabled.
sort
optional
string
Sorting order. One of: asc or desc Default: desc
Body Parameters
extIds
required
array
One or many external IDs, that used for search. Should be sent as array of strings.
200: OK
Success
{
"result":
[
{
"chainId": "9aa8eebdaa9e6ba6790dd27692519530c046e08be73fe488597947205cc563c0",
"extIds": [
"RmFjdG9tIE9wZW4gQVBJ",
"UEhQIFNESyBUZXN0"
],
"status": "queue",
"synced": false,
"createdAt": "2019-04-18T20:03:00Z",
"links": [
{
"rel": "entries",
"href": "/chain/9aa8eebdaa9e6ba6790dd27692519530c046e08be73fe488597947205cc563c0/entries"
},
{
"rel": "firstEntry",
"href": "/chain/9aa8eebdaa9e6ba6790dd27692519530c046e08be73fe488597947205cc563c0/entries/first"
},
{
"rel": "lastEntry",
"href": "/chain/9aa8eebdaa9e6ba6790dd27692519530c046e08be73fe488597947205cc563c0/entries/last"
}
]
},
{
}
]
}
400: Bad Request
Pagination error Validation error
{
"result": false,
"code": 1420,
"error": "Key: 'Chain.Status' Error:Field validation for 'Status' failed on the 'oneof' tag"
}
500: Internal Server Error
Internal server error
{
"result": false,
"code": 1510,
"error": "Internal server error"
}