search

Metadata

Learn how to work with metadata using the Alphamoon REST API

hashtag
Filter collections by the value

Using the Alphamoon API you can filter collections by set metadata values.

For example, if you want to filter only these collections that have already been printed, use the Get collections endpoint:

GET /api/v0.3/processes/{process_id}/collections

In the metadata section include the relevant query. In our case it will be:

{"printed": "yes"}
{
  "collections": [
    {
      "id": "191719e01ae84f02993168ef95be3c49",
      "name": "Invoice example.pdf",
      "files": [
        {
          "id": "0164f04d3a1e4138b73bb84695395871",
          "collectionId": "191719e01ae84f02993168ef95be3c49",
          "name": "Invoice example.pdf",
          "status": "Accepted",
          "progress": 100,
          "numberOfPages": 1,
          "createdAt": "2024-04-15T15:03:38Z",
          "updatedAt": "2024-04-16T12:29:07Z",
          "metadata": {}
        }
      ],
      "priority": false,
      "split": false,
      "status": "Accepted",
      "progress": 100,
      "numberOfPages": 1,
      "processId": "93580f176efb48cda64f25cba74d8ca4",
      "createdAt": "2024-04-15T15:03:38Z",
      "updatedAt": "2024-04-29T12:56:52Z",
      "metadata": {
        "printed": "yes"
      },
      "availableForTraining": true,
      "duplicates": []
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 100,
    "total": 1
  }
}

See the example:

hashtag
Filter collections by key

Alphamoon API enables you to also filter collection based on the previously defined keys ("true" or "false" option). Let's say you want to see only collections that have a created "printed" key. To do that, use the Get collections endpoint:

GET /api/v0.3/processes/{process_id}/collections

In the metadata section include the relevant query. In our case it will be:

In the response you will get all collections for which the "printed" key was defined:

See the example:

See next:

PreviousGet collectionsNextSetting metadata value

Last updated