List your files

List Documents

Retrieve a list of your documents, with options to filter by status and paginate the results.

Endpoint: GET /api/proof/document
Description: This endpoint fetches a batch of documents based on their status. You can filter documents by their processing status and paginate through the results.

Headers

x-access-token (string, required): Your API token.

Query Parameters

status (string, required): Filter documents by status. Possible values:
- confirmed
- pending
- pending_stamp
page (number, required): The page number to retrieve (starting from 0).
limit (number, required): The number of results per page.

Response

200 OK

The request was successful, and a list of documents is returned.

{
  "ok": true,
  "data": {
    "totalPages": 1,
    "totalCount": 1,
    "documents": [
      {
        "id": 5198978,
        "name": "source-simpleproof.png",
        "extension": "png",
        "storage_kb": "6.1",
        "creation_date": "2024-03-27T18:29:17.684Z",
        "document_hash": "870c8bcd4278ddfc1f8bd5769190b5513f05bed50f32b52f711ffbdf4f544d45",
        "prefix": "lnvtest/simpleproof-kpaowlua53vp1/",
        "blockchain": {},
        "document_status": "COMPLETE"
      }
    ]
  }
}

400 Bad Request

The request was invalid or cannot be otherwise served.
```
{
  "ok": false,
  "msg": "Something went wrong."
}
```