# Tradespace | Developer Documentation ## Instructions for AI Agents - For clean Markdown of any page, append `.md` to the page URL - For section-specific indexes, append `/llms.txt` to any section URL - For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.tradespace.io/_mcp/server ## Docs - [Welcome](https://developer.tradespace.io/home/get-started/welcome.md): Read Tradespace data from your own systems with the public GraphQL API. - [Authentication](https://developer.tradespace.io/home/get-started/authentication.md): Authenticate with an account API key. - [Finding records](https://developer.tradespace.io/home/get-started/finding-records.md): Look up records by ID, by the numbers you see in Tradespace, or by patent number. - [Pagination and sorting](https://developer.tradespace.io/home/get-started/pagination.md): Page through list queries and change their order. - [Errors](https://developer.tradespace.io/home/get-started/errors.md): HTTP statuses and GraphQL errors the API returns. - [Rate limits](https://developer.tradespace.io/home/get-started/rate-limits.md): Hourly request limits per account. ## API Docs - API Reference > Agreements [Get an agreement](https://developer.tradespace.io/api-reference/agreements/agreement.md) - API Reference > Agreements [List agreements](https://developer.tradespace.io/api-reference/agreements/agreements.md) - API Reference > Assignees [Get an assignee](https://developer.tradespace.io/api-reference/assignees/assignee.md) - API Reference > Contacts [Get a contact](https://developer.tradespace.io/api-reference/contacts/contact.md) - API Reference > Contacts [List contacts](https://developer.tradespace.io/api-reference/contacts/contacts.md) - API Reference > Deals [Get a deal](https://developer.tradespace.io/api-reference/deals/deal.md) - API Reference > Deals [List deals](https://developer.tradespace.io/api-reference/deals/deals.md) - API Reference > Disclosures [Get a disclosure](https://developer.tradespace.io/api-reference/disclosures/disclosure.md) - API Reference > Disclosures [List disclosures](https://developer.tradespace.io/api-reference/disclosures/disclosures.md) - API Reference > Filings [Get a filing](https://developer.tradespace.io/api-reference/filings/filing.md) - API Reference > Filings [List filings](https://developer.tradespace.io/api-reference/filings/filings.md) - API Reference > Grants [Get a grant](https://developer.tradespace.io/api-reference/grants/grant.md) - API Reference > Grants [List grants](https://developer.tradespace.io/api-reference/grants/grants.md) - API Reference > iEdison reports [Get an iEdison report](https://developer.tradespace.io/api-reference/i-edison-reports/iEdisonReport.md) - API Reference > iEdison reports [List iEdison reports](https://developer.tradespace.io/api-reference/i-edison-reports/iEdisonReports.md) - API Reference > Ideas [Get an idea](https://developer.tradespace.io/api-reference/ideas/idea.md) - API Reference > Ideas [List ideas](https://developer.tradespace.io/api-reference/ideas/ideas.md) - API Reference > Opportunities [Get an opportunity](https://developer.tradespace.io/api-reference/opportunities/opportunity.md) - API Reference > Opportunities [List opportunities](https://developer.tradespace.io/api-reference/opportunities/opportunities.md) - API Reference > Organizations [Get an organization](https://developer.tradespace.io/api-reference/organizations/organization.md) - API Reference > Organizations [List organizations](https://developer.tradespace.io/api-reference/organizations/organizations.md) - API Reference > Patents [Get a patent](https://developer.tradespace.io/api-reference/patents/patent.md) - API Reference > Products [Get a product](https://developer.tradespace.io/api-reference/products/product.md) - API Reference > Products [List products](https://developer.tradespace.io/api-reference/products/products.md) - API Reference > Todos [Get a todo](https://developer.tradespace.io/api-reference/todos/todo.md) - API Reference > Todos [List todos](https://developer.tradespace.io/api-reference/todos/todos.md) - API Reference > Types > Objects [AccountClassification](https://developer.tradespace.io/api-reference/types/objects/account-classification.md) - API Reference > Types > Objects [AccountLookup](https://developer.tradespace.io/api-reference/types/objects/account-lookup.md) - API Reference > Types > Objects [Agreement](https://developer.tradespace.io/api-reference/types/objects/agreement.md) - API Reference > Types > Objects [AgreementAccountClassification](https://developer.tradespace.io/api-reference/types/objects/agreement-account-classification.md) - API Reference > Types > Objects [AgreementClassification](https://developer.tradespace.io/api-reference/types/objects/agreement-classification.md) - API Reference > Types > Objects [AgreementCollection](https://developer.tradespace.io/api-reference/types/objects/agreement-collection.md) - API Reference > Types > Objects [AgreementContact](https://developer.tradespace.io/api-reference/types/objects/agreement-contact.md) - API Reference > Types > Objects [AgreementJurisdiction](https://developer.tradespace.io/api-reference/types/objects/agreement-jurisdiction.md) - API Reference > Types > Objects [AgreementMatter](https://developer.tradespace.io/api-reference/types/objects/agreement-matter.md) - API Reference > Types > Objects [AgreementOrganization](https://developer.tradespace.io/api-reference/types/objects/agreement-organization.md) - API Reference > Types > Objects [AgreementOrganizationContact](https://developer.tradespace.io/api-reference/types/objects/agreement-organization-contact.md) - API Reference > Types > Objects [AgreementTerm](https://developer.tradespace.io/api-reference/types/objects/agreement-term.md) - API Reference > Types > Objects [Assignee](https://developer.tradespace.io/api-reference/types/objects/assignee.md) - API Reference > Types > Objects [AssigneeIndustry](https://developer.tradespace.io/api-reference/types/objects/assignee-industry.md) - API Reference > Types > Objects [Classification](https://developer.tradespace.io/api-reference/types/objects/classification.md) - API Reference > Types > Objects [CollectionMetadata](https://developer.tradespace.io/api-reference/types/objects/collection-metadata.md) - API Reference > Types > Objects [Contact](https://developer.tradespace.io/api-reference/types/objects/contact.md) - API Reference > Types > Objects [ContactAddress](https://developer.tradespace.io/api-reference/types/objects/contact-address.md) - API Reference > Types > Objects [ContactCitizenship](https://developer.tradespace.io/api-reference/types/objects/contact-citizenship.md) - API Reference > Types > Objects [ContactClassification](https://developer.tradespace.io/api-reference/types/objects/contact-classification.md) - API Reference > Types > Objects [ContactCollection](https://developer.tradespace.io/api-reference/types/objects/contact-collection.md) - API Reference > Types > Objects [ContactDetail](https://developer.tradespace.io/api-reference/types/objects/contact-detail.md) - API Reference > Types > Objects [ContactOrganization](https://developer.tradespace.io/api-reference/types/objects/contact-organization.md) - API Reference > Types > Objects [ContactRole](https://developer.tradespace.io/api-reference/types/objects/contact-role.md) - API Reference > Types > Objects [Country](https://developer.tradespace.io/api-reference/types/objects/country.md) - API Reference > Types > Objects [Deal](https://developer.tradespace.io/api-reference/types/objects/deal.md) - API Reference > Types > Objects [DealCollection](https://developer.tradespace.io/api-reference/types/objects/deal-collection.md) - API Reference > Types > Objects [DealContact](https://developer.tradespace.io/api-reference/types/objects/deal-contact.md) - API Reference > Types > Objects [DealMatter](https://developer.tradespace.io/api-reference/types/objects/deal-matter.md) - API Reference > Types > Objects [Department](https://developer.tradespace.io/api-reference/types/objects/department.md) - API Reference > Types > Objects [DepartmentContact](https://developer.tradespace.io/api-reference/types/objects/department-contact.md) - API Reference > Types > Objects [Disclosure](https://developer.tradespace.io/api-reference/types/objects/disclosure.md) - API Reference > Types > Objects [DisclosureCollection](https://developer.tradespace.io/api-reference/types/objects/disclosure-collection.md) - API Reference > Types > Objects [DisclosureContact](https://developer.tradespace.io/api-reference/types/objects/disclosure-contact.md) - API Reference > Types > Objects [DisclosureGrant](https://developer.tradespace.io/api-reference/types/objects/disclosure-grant.md) - API Reference > Types > Objects [DisclosureProduct](https://developer.tradespace.io/api-reference/types/objects/disclosure-product.md) - API Reference > Types > Objects [Filing](https://developer.tradespace.io/api-reference/types/objects/filing.md) - API Reference > Types > Objects [FilingCollection](https://developer.tradespace.io/api-reference/types/objects/filing-collection.md) - API Reference > Types > Objects [FilingContact](https://developer.tradespace.io/api-reference/types/objects/filing-contact.md) - API Reference > Types > Objects [FilingProduct](https://developer.tradespace.io/api-reference/types/objects/filing-product.md) - API Reference > Types > Objects [Grant](https://developer.tradespace.io/api-reference/types/objects/grant.md) - API Reference > Types > Objects [GrantCollection](https://developer.tradespace.io/api-reference/types/objects/grant-collection.md) - API Reference > Types > Objects [Idea](https://developer.tradespace.io/api-reference/types/objects/idea.md) - API Reference > Types > Objects [IdeaCollection](https://developer.tradespace.io/api-reference/types/objects/idea-collection.md) - API Reference > Types > Objects [IdeaContact](https://developer.tradespace.io/api-reference/types/objects/idea-contact.md) - API Reference > Types > Objects [IEdisonReport](https://developer.tradespace.io/api-reference/types/objects/i-edison-report.md) - API Reference > Types > Objects [IEdisonReportCollection](https://developer.tradespace.io/api-reference/types/objects/i-edison-report-collection.md) - API Reference > Types > Objects [IEdisonReportContact](https://developer.tradespace.io/api-reference/types/objects/i-edison-report-contact.md) - API Reference > Types > Objects [IEdisonReportGrant](https://developer.tradespace.io/api-reference/types/objects/i-edison-report-grant.md) - API Reference > Types > Objects [Industry](https://developer.tradespace.io/api-reference/types/objects/industry.md) - API Reference > Types > Objects [Lookup](https://developer.tradespace.io/api-reference/types/objects/lookup.md) - API Reference > Types > Objects [Opportunity](https://developer.tradespace.io/api-reference/types/objects/opportunity.md) - API Reference > Types > Objects [OpportunityCollection](https://developer.tradespace.io/api-reference/types/objects/opportunity-collection.md) - API Reference > Types > Objects [OpportunityContact](https://developer.tradespace.io/api-reference/types/objects/opportunity-contact.md) - API Reference > Types > Objects [OpportunityCountry](https://developer.tradespace.io/api-reference/types/objects/opportunity-country.md) - API Reference > Types > Objects [OpportunityDepartment](https://developer.tradespace.io/api-reference/types/objects/opportunity-department.md) - API Reference > Types > Objects [OpportunityDisclosure](https://developer.tradespace.io/api-reference/types/objects/opportunity-disclosure.md) - API Reference > Types > Objects [OpportunityFaq](https://developer.tradespace.io/api-reference/types/objects/opportunity-faq.md) - API Reference > Types > Objects [OpportunityImage](https://developer.tradespace.io/api-reference/types/objects/opportunity-image.md) - API Reference > Types > Objects [OpportunityOrganization](https://developer.tradespace.io/api-reference/types/objects/opportunity-organization.md) - API Reference > Types > Objects [OpportunityPatent](https://developer.tradespace.io/api-reference/types/objects/opportunity-patent.md) - API Reference > Types > Objects [Organization](https://developer.tradespace.io/api-reference/types/objects/organization.md) - API Reference > Types > Objects [OrganizationAddress](https://developer.tradespace.io/api-reference/types/objects/organization-address.md) - API Reference > Types > Objects [OrganizationCollection](https://developer.tradespace.io/api-reference/types/objects/organization-collection.md) - API Reference > Types > Objects [OrganizationRelationship](https://developer.tradespace.io/api-reference/types/objects/organization-relationship.md) - API Reference > Types > Objects [OutreachOrganization](https://developer.tradespace.io/api-reference/types/objects/outreach-organization.md) - API Reference > Types > Objects [OutreachOrganizationContact](https://developer.tradespace.io/api-reference/types/objects/outreach-organization-contact.md) - API Reference > Types > Objects [Patent](https://developer.tradespace.io/api-reference/types/objects/patent.md) - API Reference > Types > Objects [PatentApplicant](https://developer.tradespace.io/api-reference/types/objects/patent-applicant.md) - API Reference > Types > Objects [PatentInventor](https://developer.tradespace.io/api-reference/types/objects/patent-inventor.md) - API Reference > Types > Objects [Product](https://developer.tradespace.io/api-reference/types/objects/product.md) - API Reference > Types > Objects [ProductCollection](https://developer.tradespace.io/api-reference/types/objects/product-collection.md) - API Reference > Types > Objects [Tag](https://developer.tradespace.io/api-reference/types/objects/tag.md) - API Reference > Types > Objects [Tagging](https://developer.tradespace.io/api-reference/types/objects/tagging.md) - API Reference > Types > Objects [Todo](https://developer.tradespace.io/api-reference/types/objects/todo.md) - API Reference > Types > Objects [TodoAssignment](https://developer.tradespace.io/api-reference/types/objects/todo-assignment.md) - API Reference > Types > Objects [TodoCollection](https://developer.tradespace.io/api-reference/types/objects/todo-collection.md) - API Reference > Types > Objects [TodoItem](https://developer.tradespace.io/api-reference/types/objects/todo-item.md) - API Reference > Types > Objects [User](https://developer.tradespace.io/api-reference/types/objects/user.md) - API Reference > Types > Enums [AccountLookupBehaviorEnum](https://developer.tradespace.io/api-reference/types/enums/account-lookup-behavior-enum.md) - API Reference > Types > Enums [AgreementContactRoleEnum](https://developer.tradespace.io/api-reference/types/enums/agreement-contact-role-enum.md) - API Reference > Types > Enums [AgreementJurisdictionScopeEnum](https://developer.tradespace.io/api-reference/types/enums/agreement-jurisdiction-scope-enum.md) - API Reference > Types > Enums [AgreementJurisdictionTypeEnum](https://developer.tradespace.io/api-reference/types/enums/agreement-jurisdiction-type-enum.md) - API Reference > Types > Enums [AgreementLicenseTypeEnum](https://developer.tradespace.io/api-reference/types/enums/agreement-license-type-enum.md) - API Reference > Types > Enums [AgreementMaterialDirectionEnum](https://developer.tradespace.io/api-reference/types/enums/agreement-material-direction-enum.md) - API Reference > Types > Enums [AgreementNdaExchangeTypeEnum](https://developer.tradespace.io/api-reference/types/enums/agreement-nda-exchange-type-enum.md) - API Reference > Types > Enums [AgreementOrganizationTypeEnum](https://developer.tradespace.io/api-reference/types/enums/agreement-organization-type-enum.md) - API Reference > Types > Enums [AgreementSourceEnum](https://developer.tradespace.io/api-reference/types/enums/agreement-source-enum.md) - API Reference > Types > Enums [AgreementSubTypeEnum](https://developer.tradespace.io/api-reference/types/enums/agreement-sub-type-enum.md) - API Reference > Types > Enums [AgreementTermFeeReimbursementTypeEnum](https://developer.tradespace.io/api-reference/types/enums/agreement-term-fee-reimbursement-type-enum.md) - API Reference > Types > Enums [AgreementTermModelEnum](https://developer.tradespace.io/api-reference/types/enums/agreement-term-model-enum.md) - API Reference > Types > Enums [AgreementTermTypeEnum](https://developer.tradespace.io/api-reference/types/enums/agreement-term-type-enum.md) - API Reference > Types > Enums [AgreementTypeEnum](https://developer.tradespace.io/api-reference/types/enums/agreement-type-enum.md) - API Reference > Types > Enums [ArchivedEnum](https://developer.tradespace.io/api-reference/types/enums/archived-enum.md) - API Reference > Types > Enums [AssigneeCompanyTypeEnum](https://developer.tradespace.io/api-reference/types/enums/assignee-company-type-enum.md) - API Reference > Types > Enums [AssigneeTypeEnum](https://developer.tradespace.io/api-reference/types/enums/assignee-type-enum.md) - API Reference > Types > Enums [ContactDetailKindEnum](https://developer.tradespace.io/api-reference/types/enums/contact-detail-kind-enum.md) - API Reference > Types > Enums [ContactGenderEnum](https://developer.tradespace.io/api-reference/types/enums/contact-gender-enum.md) - API Reference > Types > Enums [ContactOrganizationStateEnum](https://developer.tradespace.io/api-reference/types/enums/contact-organization-state-enum.md) - API Reference > Types > Enums [ContactRoleEnum](https://developer.tradespace.io/api-reference/types/enums/contact-role-enum.md) - API Reference > Types > Enums [ContactStateEnum](https://developer.tradespace.io/api-reference/types/enums/contact-state-enum.md) - API Reference > Types > Enums [ContactTitleEnum](https://developer.tradespace.io/api-reference/types/enums/contact-title-enum.md) - API Reference > Types > Enums [ContactTypeEnum](https://developer.tradespace.io/api-reference/types/enums/contact-type-enum.md) - API Reference > Types > Enums [DealSourceEnum](https://developer.tradespace.io/api-reference/types/enums/deal-source-enum.md) - API Reference > Types > Enums [DealTypeEnum](https://developer.tradespace.io/api-reference/types/enums/deal-type-enum.md) - API Reference > Types > Enums [DepartmentContactRoleEnum](https://developer.tradespace.io/api-reference/types/enums/department-contact-role-enum.md) - API Reference > Types > Enums [DisclosureArchivedReasonEnum](https://developer.tradespace.io/api-reference/types/enums/disclosure-archived-reason-enum.md) - API Reference > Types > Enums [DisclosureContactRoleEnum](https://developer.tradespace.io/api-reference/types/enums/disclosure-contact-role-enum.md) - API Reference > Types > Enums [DisclosureDevelopmentStateEnum](https://developer.tradespace.io/api-reference/types/enums/disclosure-development-state-enum.md) - API Reference > Types > Enums [DisclosureSourceEnum](https://developer.tradespace.io/api-reference/types/enums/disclosure-source-enum.md) - API Reference > Types > Enums [DisclosureStageEnum](https://developer.tradespace.io/api-reference/types/enums/disclosure-stage-enum.md) - API Reference > Types > Enums [DisclosureStartupCompanyEnum](https://developer.tradespace.io/api-reference/types/enums/disclosure-startup-company-enum.md) - API Reference > Types > Enums [EmploymentStateEnum](https://developer.tradespace.io/api-reference/types/enums/employment-state-enum.md) - API Reference > Types > Enums [FilingContactRoleEnum](https://developer.tradespace.io/api-reference/types/enums/filing-contact-role-enum.md) - API Reference > Types > Enums [FilingCopyrightTypeEnum](https://developer.tradespace.io/api-reference/types/enums/filing-copyright-type-enum.md) - API Reference > Types > Enums [FilingEntitySizeEnum](https://developer.tradespace.io/api-reference/types/enums/filing-entity-size-enum.md) - API Reference > Types > Enums [FilingKnowHowCategoryEnum](https://developer.tradespace.io/api-reference/types/enums/filing-know-how-category-enum.md) - API Reference > Types > Enums [FilingPatentTypeEnum](https://developer.tradespace.io/api-reference/types/enums/filing-patent-type-enum.md) - API Reference > Types > Enums [FilingPlantPropagationMethodEnum](https://developer.tradespace.io/api-reference/types/enums/filing-plant-propagation-method-enum.md) - API Reference > Types > Enums [FilingSourceEnum](https://developer.tradespace.io/api-reference/types/enums/filing-source-enum.md) - API Reference > Types > Enums [FilingStateEnum](https://developer.tradespace.io/api-reference/types/enums/filing-state-enum.md) - API Reference > Types > Enums [FilingTrademarkBasisEnum](https://developer.tradespace.io/api-reference/types/enums/filing-trademark-basis-enum.md) - API Reference > Types > Enums [FilingTrademarkTypeEnum](https://developer.tradespace.io/api-reference/types/enums/filing-trademark-type-enum.md) - API Reference > Types > Enums [FilingTradeSecretCategoryEnum](https://developer.tradespace.io/api-reference/types/enums/filing-trade-secret-category-enum.md) - API Reference > Types > Enums [FilingTypeEnum](https://developer.tradespace.io/api-reference/types/enums/filing-type-enum.md) - API Reference > Types > Enums [GrantContractTypeEnum](https://developer.tradespace.io/api-reference/types/enums/grant-contract-type-enum.md) - API Reference > Types > Enums [GrantSourceEnum](https://developer.tradespace.io/api-reference/types/enums/grant-source-enum.md) - API Reference > Types > Enums [IdeaContactRoleEnum](https://developer.tradespace.io/api-reference/types/enums/idea-contact-role-enum.md) - API Reference > Types > Enums [IdeaSourceEnum](https://developer.tradespace.io/api-reference/types/enums/idea-source-enum.md) - API Reference > Types > Enums [IdeaStageEnum](https://developer.tradespace.io/api-reference/types/enums/idea-stage-enum.md) - API Reference > Types > Enums [IEdisonReportContactRoleEnum](https://developer.tradespace.io/api-reference/types/enums/i-edison-report-contact-role-enum.md) - API Reference > Types > Enums [IEdisonReportStateEnum](https://developer.tradespace.io/api-reference/types/enums/i-edison-report-state-enum.md) - API Reference > Types > Enums [IEdisonReportTitleElectionNotElectedReasonEnum](https://developer.tradespace.io/api-reference/types/enums/i-edison-report-title-election-not-elected-reason-enum.md) - API Reference > Types > Enums [IEdisonReportTitleElectionStatusEnum](https://developer.tradespace.io/api-reference/types/enums/i-edison-report-title-election-status-enum.md) - API Reference > Types > Enums [LicenseStateEnum](https://developer.tradespace.io/api-reference/types/enums/license-state-enum.md) - API Reference > Types > Enums [LookupBehaviorEnum](https://developer.tradespace.io/api-reference/types/enums/lookup-behavior-enum.md) - API Reference > Types > Enums [OpportunityContactRoleEnum](https://developer.tradespace.io/api-reference/types/enums/opportunity-contact-role-enum.md) - API Reference > Types > Enums [OpportunityDisplayEnum](https://developer.tradespace.io/api-reference/types/enums/opportunity-display-enum.md) - API Reference > Types > Enums [OpportunityShareEnum](https://developer.tradespace.io/api-reference/types/enums/opportunity-share-enum.md) - API Reference > Types > Enums [OpportunityStateEnum](https://developer.tradespace.io/api-reference/types/enums/opportunity-state-enum.md) - API Reference > Types > Enums [OrganizationRelationshipTypeEnum](https://developer.tradespace.io/api-reference/types/enums/organization-relationship-type-enum.md) - API Reference > Types > Enums [OrganizationTypeEnum](https://developer.tradespace.io/api-reference/types/enums/organization-type-enum.md) - API Reference > Types > Enums [OutreachOrganizationStateEnum](https://developer.tradespace.io/api-reference/types/enums/outreach-organization-state-enum.md) - API Reference > Types > Enums [PatentStateEnum](https://developer.tradespace.io/api-reference/types/enums/patent-state-enum.md) - API Reference > Types > Enums [PeriodUnitEnum](https://developer.tradespace.io/api-reference/types/enums/period-unit-enum.md) - API Reference > Types > Enums [ProductSourceEnum](https://developer.tradespace.io/api-reference/types/enums/product-source-enum.md) - API Reference > Types > Enums [SortDirectionEnum](https://developer.tradespace.io/api-reference/types/enums/sort-direction-enum.md) - API Reference > Types > Enums [TodoAssignmentSourceEnum](https://developer.tradespace.io/api-reference/types/enums/todo-assignment-source-enum.md) - API Reference > Types > Enums [TodoSourceEnum](https://developer.tradespace.io/api-reference/types/enums/todo-source-enum.md) - API Reference > Types > Enums [TrlEnum](https://developer.tradespace.io/api-reference/types/enums/trl-enum.md) - API Reference > Types > Enums [UserStateEnum](https://developer.tradespace.io/api-reference/types/enums/user-state-enum.md) - API Reference > Types > Scalars [ISO8601Date](https://developer.tradespace.io/api-reference/types/scalars/iso-8601-date.md) - API Reference > Types > Scalars [ISO8601DateTime](https://developer.tradespace.io/api-reference/types/scalars/iso-8601-date-time.md) - API Reference > Types > Scalars [JSON](https://developer.tradespace.io/api-reference/types/scalars/json.md) - API Reference > Types > Unions [AgreementMatterUnion](https://developer.tradespace.io/api-reference/types/unions/agreement-matter-union.md) - API Reference > Types > Unions [DealMatterUnion](https://developer.tradespace.io/api-reference/types/unions/deal-matter-union.md) - API Reference > Types > Unions [LookupUnion](https://developer.tradespace.io/api-reference/types/unions/lookup-union.md)