List documents¶

GET https://api.moalmanac.org/documents

Retrieves Documents from the database. Filters by document_id, agent, and agent_id. Only Active documents are returned, unless include_deprecated=true, which also returns Deprecated documents. Deprecated documents are always returned when requested by document_id.

Parameters¶

Name	Type	Description	Example
`document_id`	string	Return only the document with this id.
`include_deprecated`	boolean, default `false`	Also return deprecated records. Ignored when requesting a single record by id, which is always returned.
`document`	string (repeatable)	Document id. Repeatable; matches any of the given values (OR).	`doc:fda:verzenio`
`agent`	string (repeatable)	Agent name, matched exactly. Repeatable; matches any of the given values (OR).	`Van Allen lab`
`agent_id`	string (repeatable)	Agent id. Repeatable; matches any of the given values (OR).	`agent:user:vanallenlab`

Example request¶

curl "https://api.moalmanac.org/documents?document=doc%3Afda%3Averzenio"

Response¶

Returns the standard response envelope, with data set to a list of Document records.

Example response

{
  "meta": {
    "data_length": 1,
    "message": "Documents retrieved successfully",
    "request_url": "https://api.moalmanac.org/documents",
    "status": "success",
    "status_code": 200,
    "timestamp_elapsed": 0.012345,
    "timestamp_received": "2026-10-16T14:03:12.123456Z",
    "timestamp_returned": "2026-10-16T14:03:12.135801Z",
    "trace_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  },
  "service": {
    "github": "https://github.com/vanallenlab/moalmanac-db",
    "name": "Molecular Oncology Almanac",
    "license": "GPL-2.0",
    "release": "draft",
    "url": "https://moalmanac.org",
    "last_updated": "2026-10-08"
  },
  "data": [
    {
      "id": "doc:fda:tafinlar",
      "type": "Document",
      "documentType": "Regulatory approval",
      "name": "Tafinlar (dabrafenib) [package insert]. FDA.",
      "title": null,
      "aliases": [],
      "description": "Novartis Pharmaceuticals Corporation. Tafinlar (dabrafenib) [package insert]. U.S. Food and Drug Administration website. https://www.accessdata.fda.gov/drugsatfda_docs/label/2024/202806s030lbl.pdf. Revised March 2024. Accessed October 30, 2024.",
      "urls": [
        "https://www.accessdata.fda.gov/drugsatfda_docs/label/2024/202806s030lbl.pdf",
        "https://www.accessdata.fda.gov/scripts/cder/daf/index.cfm?event=overview.process&ApplNo=202806"
      ],
      "doi": null,
      "pmid": null,
      "extensions": [
        {
          "name": "agent",
          "value": {
            "id": "agent:org:fda",
            "type": "Agent",
            "agentType": "organization",
            "name": "Food and Drug Administration",
            "description": "Regulatory agency that approves drugs for use in the United States."
          },
          "description": "The organization that published this document."
        },
        {
          "name": "company",
          "value": "Novartis Pharmaceuticals Corporation.",
          "description": "The company that manufactures the cancer drug. Only applicable to market authorization documents."
        },
        {
          "name": "drug_name_brand",
          "value": "Tafinlar",
          "description": "The brand name of the cancer drug, per this document. Only applicable to market authorization documents."
        },
        {
          "name": "drug_name_generic",
          "value": "dabrafenib",
          "description": "The generic name of the cancer drug, per this document. Only applicable to market authorization documents."
        },
        {
          "name": "first_publication_date",
          "value": null,
          "description": "The publication date for the initial version of this document."
        },
        {
          "name": "publication_date",
          "value": "2024-03-29",
          "description": "The publication date for the document."
        },
        {
          "name": "regulatory_identifier",
          "value": "NDA202806",
          "description": "Identifier assigned by the regulatory agency, such as an FDA application number (e.g. NDA208716, BLA125427) or an EMA product number (e.g. EMEA/H/C/006184)."
        },
        {
          "name": "status",
          "value": "Active",
          "description": "Whether this document is Active or Deprecated within moalmanac-db."
        }
      ]
    }
  ]
}