Skip to content

Main features

Base URL: https://api-work.eu.veri-das.com/id-data-storage

File listing

The ID Data Storage API allows you to list files stored in a bucket, categorized by their status folders. Built‑in status folders are approved and rejected, and custom status folders (e.g. old_provider) can also be queried using the same status query parameter. If you omit status, the service may return files across all accessible status folders (implementation dependent). Pagination parameters are available to handle large file sets.

How to list files

  1. Send a GET request to /id-data-storage/v1/list
  2. Include the bucket identifier in the apikey header
  3. Optional query parameters:
    • status: Name of a status folder (approved, rejected, or a custom one like old_provider)
    • page: Page number (default: 1)
    • page_size: Number of results per page (default: 50)
  4. The API returns JSON with:
    • files: Array of file objects
    • available_statuses: Accessible status folders (built‑in and custom)
    • page, total_files, total_pages
    • status: "ok" on success

Example request (built‑in status)

GET /id-data-storage/v1/list?status=approved&page=1&page_size=10 HTTP/1.1
Host: api.<region>.veri-das.com
apikey: your-api-key

Example request (custom status folder)

GET /id-data-storage/v1/list?status=old_provider&page=1&page_size=10 HTTP/1.1
Host: api.<region>.veri-das.com
apikey: your-api-key

Example request (no status parameter)

GET /id-data-storage/v1/list?page=1&page_size=10 HTTP/1.1
Host: api.<region>.veri-das.com
apikey: your-api-key

Example response

{
  "available_statuses": [
    "approved",
    "old_provider",
    "rejected"
  ],
  "files": [
    {
      "name": "000426bfc73146d090300b1183edbe20.zip",
      "status": "approved"
    },
    {
      "name": "000a15cba0e84255ba4ca208dd531c45.zip",
      "status": "approved"
    }
  ],
  "page": 1,
  "status": "ok",
  "total_files": 15251,
  "total_pages": 7626
}

File download

Download a single file by its name from a specific status folder (built‑in or custom). Always provide the status to avoid ambiguity.

How to download files

  1. Send a GET request to /id-data-storage/v1/download
  2. Include the bucket identifier in the apikey header
  3. Required query parameters:
    • filename: Name of the file
    • status: Status folder containing the file (approved, rejected, or custom)

Example request (built‑in status)

GET /id-data-storage/v1/download?filename=example.zip&status=approved HTTP/1.1
Host: api.<region>.veri-das.com
apikey: your-api-key

Example request (custom status folder)

GET /id-data-storage/v1/download?filename=example.zip&status=old_provider HTTP/1.1
Host: api.<region>.veri-das.com
apikey: your-api-key