List documents
This endpoint is cached by default with a TTL of 60 seconds.
List documents
GET
https://api.zapsign.com.br/api/v1/docs/?page=1
This endpoint allows you to list all documents in your account.
Query Parameters
Headers
Filtering documents by folder
If you only want to filter documents from a certain folder, add the optional parameter "folder_path" to the GET. For example:
All documents in the account (no folder filter): https://api.zapsign.com.br/api/v1/docs/?api_token=abc&page=1
Filtering only documents without a folder (i.e. at the root "/"): https://api.zapsign.com.br/api/v1/docs/?api_token=abc&page=1&folder_path=/
Filtering only documents in the "/api/folder2/" folder: https://api.zapsign.com.br/api/v1/docs/?api_token=abc&page=1&folder_path=/api/pasta2/
Filtering deleted or non-deleted documents
If you wish to filter only deleted or non-deleted documents, add the optional "deleted" parameter to the GET request. For example:
Only non-deleted documents: https://api.zapsign.com.br/api/v1/docs/?page=1&deleted=false
Only deleted documents: https://api.zapsign.com.br/api/v1/docs/?page=1&deleted=true
Filtering documents by status
If you wish to filter only signed, pending or refused documents, add the optional "status" parameter to the GET request. For example:
Only signed documents: https://api.zapsign.com.br/api/v1/docs/?page=1&status=signed
Only pending documents: https://api.zapsign.com.br/api/v1/docs/?page=1&status=pending
Only refused documents: https://api.zapsign.com.br/api/v1/docs/?page=1&status=refused
Filtering documents by creation date
If you wish to filter documents by creation date, add the optional parameters 'created_from' and 'created_to' to the GET request, with the format YYYY-MM-DD. For example:
Only documents created on January, 2024: https://api.zapsign.com.br/api/v1/docs/?page=1&created_from=2024-01-01&created_to=2024-01-30
Ordering the response of the request
If you wish to sort the response of the document listing by creation date, add the optional parameter 'sort_order' to the GET request. For example:
Sorting documents in ascending order: https://api.zapsign.com.br/api/v1/docs/?page=1&sort_order=asc
Sorting documents in descending order: https://api.zapsign.com.br/api/v1/docs/?page=1&sort_order=desc
Tip: instead of consulting documents several times a day, use our webhooks. In addition to saving the computing power of our servers and our servers, you will also be able to give feedback in real time to your user, not every N minutes.
Request
Response
Caution: the original_file and signed_file links are temporary and expires in 60 minutes. In case your system needs to save those links it is recommended that you save them in your own CDN or that you call this endpoint every time your user needs a valid URL that will expires in more 60 minutes.
Last updated