Skip to main content

BD2K Minimum Viable Identifier

Project description

A minid (Minimal Viable Identifier) is an identifier that is sufficiently simple to make creation and use trivial, while still having enough substance to make data easily findable, accessible, interoperable, and reusable (FAIR).

The minid server code is avaialble at


The minid client and CLI is avaialble on PyPI. You can install it with the following command:

$ pip install minid

Alternatively, you can download the source code and install using setup tools:

$ git clone

$ python install


Before using the API you first need to validate your email address. Enter the following command:

$ minid --register_user --email <email> --name <name> [--orcid <orcid>]

A unique code will be sent to your email address. You must present this code along with your email address when accessing the API. As a convenience you can specify this information in a minid configuration file (~/.minid/minid-config.cfg)

user: <Name>
email: <Email>
orcid: <optional Orcid>
code: <Code>


The CLI supports the following simple operations (Note: the –test flag creates names in a test namespace that is removed periodically; remove that flag to create production minids.):

  • Create a new identifier (the –location option, if provided, must be at the end):

    $ minid --test --register [--title <title>] <file_name> [--locations <loc1>..<locN>]
  • Retrieve metadata about a file:

    $ minid --test <file_name>
  • Retrieve metadata about an identifier:

    $ minid --test <identifier>
  • Update metadata about an identifier:

    $ minid --test --update [--title <title>] [--status <status>] [--obsoleted_by <minid>] [--locations <loc1> <loc2>] <identifier>
  • View all minid options:

    $ minid -h

Landing pages are accessible via the minid website:<identifier>.

file manifest format

Minids can only be assigned to a single file. In order to assign a minid to a collection of files we recommend using a BDBag or the minid file manifest format.

The minid file manifest format is a JSON-based format that enumerates a list of files as JSON objects that have the following attributes:

  • length: The length of the file in bytes.
  • filename: The filename (or path) relative to the manifest file.
  • One or more (only one of each) of the following algorithm:checksum key-value pairs:
    • md5:<md5 hex value>
    • sha256:<sha256 hex value>
    • sha512:<sha512 hex value>

Below is a sample file manifest configuration file:

        "length": 632860,
        "filename": "minid_v0.1_Nov_2015.pdf",
        "sha256": "cacc1abf711425d3c554277a5989df269cefaa906d27f1aaa72205d30224ed5f"

More information

More information about the project can be found at:

Project details

Release history Release notifications

This version
History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
minid-1.2.3.tar.gz (13.4 kB) Copy SHA256 hash SHA256 Source None Mar 28, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page