# searchNiceGuidance

**Identifier:** `nice_searchNiceGuidance`

**Provider:** [NICE - National Institute for Health and Care Excellence](https://kirha.com/providers/nice.md)

Live search of all NICE (England) guidance by keyword, programme and status: technology appraisals (including those in development with their expected publication date, terminated or awaiting development), highly specialised technologies, NICE guidelines, interventional procedures, diagnostics and HealthTech guidance. Returns guidance ids, status and dates, not recommendation outcomes: use searchNiceTechnologyAppraisals for the TA recommendation per indication.

## Run it with the CLI

```bash
kirha tools run nice_searchNiceGuidance \
  --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": "nice_searchNiceGuidance",
  "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": {
    "limit": {
      "default": 15,
      "maximum": 50,
      "minimum": 1,
      "type": "number"
    },
    "page": {
      "default": 1,
      "minimum": 1,
      "type": "number"
    },
    "programme": {
      "enum": [
        "technologyAppraisal",
        "highlySpecialisedTechnologies",
        "niceGuideline",
        "clinicalGuideline",
        "interventionalProcedure",
        "diagnostics",
        "medicalTechnology",
        "healthTech",
        "earlyValueAssessment",
        "publicHealth"
      ],
      "type": "string"
    },
    "query": {
      "description": "e.g. pembrolizumab, 'bladder cancer'",
      "type": "string"
    },
    "sortBy": {
      "default": "relevance",
      "enum": [
        "relevance",
        "lastUpdated"
      ],
      "type": "string"
    },
    "status": {
      "enum": [
        "published",
        "inDevelopment",
        "inConsultation",
        "awaitingDevelopment",
        "topicPrioritisation",
        "terminated",
        "deferred"
      ],
      "type": "string"
    }
  },
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "context": {
      "type": "string"
    },
    "guidance": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "expectedPublicationDate": {
            "type": "string"
          },
          "guidanceId": {
            "type": "string"
          },
          "lastUpdatedAt": {
            "type": "string"
          },
          "programme": {
            "type": "string"
          },
          "publishedAt": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "guidanceId",
          "title",
          "url"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "guidanceIds": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "total": {
      "type": "number"
    }
  },
  "required": [
    "context",
    "guidance",
    "total",
    "guidanceIds"
  ],
  "type": "object"
}
```

## Related tools

Other NICE - National Institute for Health and Care Excellence tools that this tool refers to, or that refer to it.

- [`searchNiceTechnologyAppraisals`](https://kirha.com/providers/nice/searchNiceTechnologyAppraisals.md)

-----

[All NICE - National Institute for Health and Care Excellence tools](https://kirha.com/providers/nice.md) · [< Back to tools list](https://kirha.com/tools.md)