> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.tradespace.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.tradespace.io/_mcp/server.

# Finding records

> Look up records by ID, by the numbers you see in Tradespace, or by patent number.

## By ID

Single-record queries such as `disclosure`, `grant`, or `agreement` take the record's `id`, a UUID returned by every query.

```graphql
query OneDisclosure {
  disclosure(id: "3f2b8c1e-5d4a-4e7b-9c1f-0a2b3c4d5e6f") {
    id
    disclosureNumber
    title
  }
}
```

`opportunity` also accepts the opportunity's slug in place of its ID.

## By number

The numbers you see in Tradespace, such as a disclosure number, are not IDs. To find a record by number, pass the number to the list query's filter and read the first result. Matching is case-insensitive.

```graphql
query DisclosureByNumber {
  disclosures(disclosureNumber: "DS16212") {
    collection { id disclosureNumber title }
  }
}
```

| Record         | List query       | Filter arguments                                                           |
| -------------- | ---------------- | -------------------------------------------------------------------------- |
| Agreement      | `agreements`     | `agreementNumber`, `externalId`                                            |
| Contact        | `contacts`       | `email`                                                                    |
| Deal           | `deals`          | `externalId`                                                               |
| Disclosure     | `disclosures`    | `disclosureNumber`                                                         |
| Filing         | `filings`        | `filingNumber`, `publicationNumber`, `grantedNumber`, `registrationNumber` |
| Grant          | `grants`         | `grantNumber`, `subcontractNumber`, `externalId`                           |
| iEdison report | `iEdisonReports` | `inventionReportNumber`                                                    |
| Idea           | `ideas`          | `ideaNumber`                                                               |
| Opportunity    | `opportunities`  | `opportunityNumber`                                                        |

Every list query also accepts `q` for a text search. Each query's `q` argument in the [API Reference](/api-reference) lists the fields it searches.

## Patents

`patent` looks up a patent or published application in the global patent database by its publication or granted number. Write the number with its country and kind codes and no spaces or punctuation, for example `US10000000B2` or `US20230123456A1`.

```graphql
query OnePatent {
  patent(patentNumber: "US10000000B2") {
    applicationNumber
    expiresOn
  }
}
```

## Organizations and assignees

* An **organization** is a company or institution in your account, such as a licensee or sponsor. Look one up with `organization(id:)` or search with `organizations`.
* An **assignee** is a company or institution in the global assignee database. Look one up with `assignee(id:)`, passing its slug: the last part of the assignee's profile URL in Tradespace (`/organizations/a/<slug>`). An assignee's `id` field returns the same slug.