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
Request
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.
Response
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"
}
​
​

Chains - Previous

GET /chains/:chainId/entries/last

Next - Chains

POST /chains/:chainId/entries/search

Last updated 10 months ago

POST /chains/search

postSearch user's chains by extIds

post
Search user's chains by extIds