> 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.

# List opportunities

GraphQL QUERY

Returns a paginated collection of opportunities.

Reference: https://developer.tradespace.io/api-reference/opportunities/opportunities

## GraphQL Schema

```graphql
query ExampleQuery($archived: ArchivedEnum, $contactIds: [String!], $createdByUserIds: [String!], $createdOnMax: ISO8601Date, $createdOnMin: ISO8601Date, $disclosureIds: [String!], $displayEnums: [OpportunityDisplayEnum!], $limit: Int, $opportunityNumber: String, $organizationIds: [String!], $page: Int, $q: String, $shareEnums: [OpportunityShareEnum!], $sortDirection: SortDirectionEnum, $sortField: String, $stateEnums: [OpportunityStateEnum!], $trlEnums: [TrlEnum!], $updatedByUserIds: [String!], $updatedOnMax: ISO8601Date, $updatedOnMin: ISO8601Date) {
  opportunities(archived: $archived, contactIds: $contactIds, createdByUserIds: $createdByUserIds, createdOnMax: $createdOnMax, createdOnMin: $createdOnMin, disclosureIds: $disclosureIds, displayEnums: $displayEnums, limit: $limit, opportunityNumber: $opportunityNumber, organizationIds: $organizationIds, page: $page, q: $q, shareEnums: $shareEnums, sortDirection: $sortDirection, sortField: $sortField, stateEnums: $stateEnums, trlEnums: $trlEnums, updatedByUserIds: $updatedByUserIds, updatedOnMax: $updatedOnMax, updatedOnMin: $updatedOnMin) {
    collection {
      additionalInformation
      archivedAt
      archivedByUser
      availabilities
      availableData
      background
      benefits
      commercialApplications
      coverImageAltText
      coverImageUrl
    }
    metadata {
      count
      currentPage
      extra
      hasNextPage
      hasPreviousPage
      limitValue
      nextPage
      previousPage
      totalCount
      totalPages
    }
  }
}
```

## Variables

```json
{
  "archived": "EXCLUDE",
  "contactIds": [
    "example"
  ],
  "createdByUserIds": [
    "example"
  ],
  "createdOnMax": "example",
  "createdOnMin": "example",
  "disclosureIds": [
    "example"
  ],
  "displayEnums": [
    "featured"
  ],
  "limit": 0,
  "opportunityNumber": "example",
  "organizationIds": [
    "example"
  ],
  "page": 0,
  "q": "example",
  "shareEnums": [
    "marketplace"
  ],
  "sortDirection": "ASC",
  "sortField": "example",
  "stateEnums": [
    "in_progress"
  ],
  "trlEnums": [
    "level_1"
  ],
  "updatedByUserIds": [
    "example"
  ],
  "updatedOnMax": "example",
  "updatedOnMin": "example"
}
```