# searchGuidanceDocuments

**Identifier:** `openfda_searchGuidanceDocuments`

**Provider:** [OpenFDA](https://kirha.com/providers/openfda.md)

Search FDA guidance documents (draft and final) by topic or title, filtered by center, status, issue date and open comment period. Returns issue date, docket number, comment close date and links to the page and PDF. Use sortBy issue_date_desc with issuedAfter for 'new guidance since X' questions.

## Run it with the CLI

```bash
kirha tools run openfda_searchGuidanceDocuments \
  --input '{}'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "openfda_searchGuidanceDocuments",
  "input": {}
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "center": {
      "enum": [
        "cder",
        "cber",
        "cdrh",
        "cvm",
        "ctp",
        "human_foods_program",
        "commissioner_office",
        "inspections_investigations",
        "regulatory_affairs"
      ],
      "type": "string"
    },
    "issuedAfter": {
      "description": "YYYY-MM-DD",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "openForComment": {
      "type": "boolean"
    },
    "query": {
      "default": "",
      "description": "e.g. biosimilar interchangeability, obesity drug development",
      "type": "string"
    },
    "sortBy": {
      "default": "relevance",
      "enum": [
        "relevance",
        "issue_date_desc",
        "issue_date_asc",
        "last_updated_desc"
      ],
      "type": "string"
    },
    "status": {
      "enum": [
        "draft",
        "final"
      ],
      "type": "string"
    }
  },
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "context": {
      "type": "string"
    },
    "documents": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "center": {
            "type": "string"
          },
          "commentCloseDate": {
            "type": "string"
          },
          "docketNumber": {
            "description": "Regulations.gov docket",
            "type": "string"
          },
          "documentType": {
            "type": "string"
          },
          "issueDate": {
            "type": "string"
          },
          "issuingOffice": {
            "type": "string"
          },
          "lastUpdated": {
            "type": "string"
          },
          "openForComment": {
            "type": "boolean"
          },
          "pdfUrl": {
            "type": "string"
          },
          "productTypes": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "status": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "topics": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "title",
          "status",
          "productTypes",
          "topics",
          "openForComment"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "context",
    "documents"
  ],
  "type": "object"
}
```

-----

[All OpenFDA tools](https://kirha.com/providers/openfda.md) · [< Back to tools list](https://kirha.com/tools.md)