> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scite.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Evidence

> Search patents, grants, clinical trials, and regulatory records alongside citation data.

The Evidence API searches non-citation research and regulatory records: patents, grants, clinical trials, FDA device/drug records, and adverse-event and safety-alert databases, sourced from Resolute's evidence datasets. Every resource below follows the **same four-endpoint pattern**, so once you've used one, you've used them all.

**Need an API key?** On Pro, create one in the [API Console](https://scite.ai/users/me/api). Creating a key doesn't grant every optional scope; see [Authentication](/authentication) for feature access. For higher limits or managed credentials, [contact sales](https://scite.ai/contact).

<Warning>
  Evidence isn't included in a standard self-service Pro key. Each dataset requires its own scope (`evidence:patents:api`, `evidence:grants:api`, `evidence:clinical-trials:api`, and equivalents for the other datasets). [Email sales](mailto:sales@scite.ai) to get a dataset scope added to your account, then generate a new key from the [API Console](https://scite.ai/users/me/api) so it picks up the scope.
</Warning>

## The pattern

For a resource `{resource}` (e.g. `patents`):

| Endpoint                                       | Purpose                                                                         |
| ---------------------------------------------- | ------------------------------------------------------------------------------- |
| `GET /api_partner/evidence/{resource}`         | Search                                                                          |
| `GET /api_partner/evidence/{resource}/schema`  | Get the filterable fields and their types for this resource                     |
| `POST /api_partner/evidence/{resource}/facets` | Get facet counts (e.g. how many results per year) without fetching full results |
| `GET /api_partner/evidence/{resource}/{id}`    | Get a single record by its ID                                                   |

Search takes two parameters, and they work differently than the [Search API](/guides/search):

* **`q`**: free-text query. Supports `AND`, `OR`, `NOT`, and phrase matching with double quotes: `q=CRISPR`, `q="gene therapy" AND cancer`.
* **`f`**: field filters, space-delimited, in `field:"value"` format (values must be double-quoted). Call the resource's `schema` endpoint to see which fields are filterable.

```bash theme={null}
curl 'https://api.scite.ai/api_partner/evidence/patents/schema' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'
```

```bash theme={null}
curl -G 'https://api.scite.ai/api_partner/evidence/patents' \
  -H 'Authorization: Bearer <YOUR_API_KEY>' \
  --data-urlencode 'q=CRISPR' \
  --data-urlencode 'f=patents.assignees.name:"Acme Corp" patents.filingStatus:"grant"'
```

Common filter fields by resource:

| Resource        | Example filters                                                                                                                                                                                               |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Patents         | `patents.filingStatus` (`"application"`, `"grant"`), `patents.assignees.name`, `patents.inventors.name`, `patents.languages` (ISO 639-1)                                                                      |
| Clinical trials | `trialState.phase` (`"Phase I"`..`"Phase IV"`, `"N/A"`), `trialState.overallStatus` (`"Recruiting"`, `"Completed"`, ...), `conditions`, `interventions.name`, `sponsors.name`, `registry`, `design.studyType` |
| Grants          | `agency`, `organization`, `piName`, `country` (ISO 3166-1 alpha-3), `dataSource` (`"NIH RePORTER"`, `"NSF"`, ...)                                                                                             |

Date range filters use `gte`/`lt` suffixes with no space before the suffix: `f=dates.startDategte:"2024-01-01" dates.startDatelt:"2025-01-01"`. ISO dates, epoch milliseconds, and timezone offsets are all accepted; dates without a timezone are treated as UTC.

Sorting uses `s` (default `_relevance`; call `schema` for sortable fields per resource) and `sortDir`, not the `sort`/`sort_order` names from Search. Pagination uses `p` (page number), not `limit`/`offset`.

<Warning>
  Some fields in search and detail responses are either a plain string or an object shaped like `{"id": "...", "name": "...", "highlighted": "..."}`, depending on the query. Handle both, e.g. `value.id ?? value.name ?? value`.
</Warning>

## Available resources

| Resource                   | Path segment           | Source data                              |
| -------------------------- | ---------------------- | ---------------------------------------- |
| Patents                    | `patents`              | Patent filings                           |
| Grants                     | `grants`               | Research grant records                   |
| Clinical trials            | `clinical-trials`      | Registered clinical trials               |
| Device clearances          | `device510k`           | FDA 510(k) device clearances             |
| Device clearance summaries | `device510k-summaries` | FDA 510(k) summary PDFs                  |
| MHRA alerts                | `mhra`                 | UK MHRA safety alerts                    |
| MAUDE reports              | `maude`                | FDA adverse event reports (devices)      |
| FAERS reports              | `faers`                | FDA adverse event reports (drugs)        |
| Drugs                      | `drugs`                | FDA drug labels, Orange Book, Drugs\@FDA |

## Related

* [Search guide](/guides/search): the equivalent search over publications, with a different query syntax than Evidence
* Full parameter reference: see **Evidence** in the API Reference tab; per-resource filters are best discovered via each resource's `/schema` endpoint
* [Errors and rate limits](/errors-and-rate-limits): troubleshoot missing dataset scopes and retryable failures