About
API methods
API authorization
API clients
API
GET /
User
GET /user
Chains
POST /chains
GET /chains
GET /chains/:chainId
GET /chains/:chainId/entries
GET /chains/:chainId/entries/first
GET /chains/:chainId/entries/last
POST /chains/search
POST /chains/:chainId/entries/search
Entries
POST /entries
GET /entries/:entryHash
Generic factomd
POST /factomd/:method
Powered by GitBook

POST /chains/:chainId/entries/search

This endpoint allows you to search among entries of the chain by one or multiple external IDs.

post
Search chain entries

http://localhost:8081/v1/chains/:chainId/entries/search
Important! `content` and `extIds` are sent and received into Base64 format. Open API SDKs automatically convert the data into Base64.
Request
Response
Request
Path Parameters
chainId
required
string
Chain ID of the Factom chain
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": [
        {
            "entryHash": "1360c874082e95840c3810e1686b06b5fdf38ade63af6e57d09aba0e885db14e",
            "chainId": "9aa8eebdaa9e6ba6790dd27692519530c046e08be73fe488597947205cc563c0",
            "extIds": [
                "RmFzdCBiYXRjaCB0ZXN0",
                "IzU3"
            ],
            "content": "VGVzdA==",
            "status": "processing",
            "createdAt": "2019-04-18T22:09:41Z"
        },
        {
            …
        }
    ]
}
400: Bad Request
Pagination error Validation error
{
    "result": false,
    "code": 1420,
    "error": "Key: 'Entry.ChainID' Error:Field validation for 'ChainID' failed on the 'hexadecimal' tag"
}
500: Internal Server Error
Internal server error
{
    "result": false,
    "code": 1510,
    "error": "Chain 7aa8eebdaa9e6ba6790dd27692519530c046e08be73fe488597947205cc563c0 not found"
}

​

​

Chains - Previous
POST /chains/search
Next - Entries
POST /entries
Last updated 1 year ago