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

GraphQL QUERY

Returns a paginated collection of agreements.

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

## GraphQL Schema

```graphql
query ExampleQuery($agreementNumber: String, $amendedAgreementIds: [String!], $archived: ArchivedEnum, $beginOnMax: ISO8601Date, $beginOnMin: ISO8601Date, $contactIds: [String!], $createdByUserIds: [String!], $createdOnMax: ISO8601Date, $createdOnMin: ISO8601Date, $disclosureIds: [String!], $effectiveOnMax: ISO8601Date, $effectiveOnMin: ISO8601Date, $executionOnMax: ISO8601Date, $executionOnMin: ISO8601Date, $expirationOnMax: ISO8601Date, $expirationOnMin: ISO8601Date, $externalId: String, $filingIds: [String!], $licenseTypeEnums: [AgreementLicenseTypeEnum!], $limit: Int, $matterTypes: [String!], $organizationIds: [String!], $page: Int, $q: String, $requestedOnMax: ISO8601Date, $requestedOnMin: ISO8601Date, $signatureOnMax: ISO8601Date, $signatureOnMin: ISO8601Date, $sortDirection: SortDirectionEnum, $sortField: String, $sourceEnums: [AgreementSourceEnum!], $statusLookupIds: [String!], $subTypeEnums: [AgreementSubTypeEnum!], $terminatedOnMax: ISO8601Date, $terminatedOnMin: ISO8601Date, $typeEnums: [AgreementTypeEnum!], $updatedByUserIds: [String!], $updatedOnMax: ISO8601Date, $updatedOnMin: ISO8601Date) {
  agreements(agreementNumber: $agreementNumber, amendedAgreementIds: $amendedAgreementIds, archived: $archived, beginOnMax: $beginOnMax, beginOnMin: $beginOnMin, contactIds: $contactIds, createdByUserIds: $createdByUserIds, createdOnMax: $createdOnMax, createdOnMin: $createdOnMin, disclosureIds: $disclosureIds, effectiveOnMax: $effectiveOnMax, effectiveOnMin: $effectiveOnMin, executionOnMax: $executionOnMax, executionOnMin: $executionOnMin, expirationOnMax: $expirationOnMax, expirationOnMin: $expirationOnMin, externalId: $externalId, filingIds: $filingIds, licenseTypeEnums: $licenseTypeEnums, limit: $limit, matterTypes: $matterTypes, organizationIds: $organizationIds, page: $page, q: $q, requestedOnMax: $requestedOnMax, requestedOnMin: $requestedOnMin, signatureOnMax: $signatureOnMax, signatureOnMin: $signatureOnMin, sortDirection: $sortDirection, sortField: $sortField, sourceEnums: $sourceEnums, statusLookupIds: $statusLookupIds, subTypeEnums: $subTypeEnums, terminatedOnMax: $terminatedOnMax, terminatedOnMin: $terminatedOnMin, typeEnums: $typeEnums, updatedByUserIds: $updatedByUserIds, updatedOnMax: $updatedOnMax, updatedOnMin: $updatedOnMin) {
    collection {
      accountLeadInstitution
      accountPastPatentExpenses
      accountShareOfNetConsideration
      accountShareOfPatentCost
      adminFeeAmount
      adminFeeCap
      adminFeePercentage
      agreementAccountClassifications
      agreementClassifications
      agreementContacts
    }
    metadata {
      count
      currentPage
      extra
      hasNextPage
      hasPreviousPage
      limitValue
      nextPage
      previousPage
      totalCount
      totalPages
    }
  }
}
```

## Variables

```json
{
  "agreementNumber": "example",
  "amendedAgreementIds": [
    "example"
  ],
  "archived": "EXCLUDE",
  "beginOnMax": "example",
  "beginOnMin": "example",
  "contactIds": [
    "example"
  ],
  "createdByUserIds": [
    "example"
  ],
  "createdOnMax": "example",
  "createdOnMin": "example",
  "disclosureIds": [
    "example"
  ],
  "effectiveOnMax": "example",
  "effectiveOnMin": "example",
  "executionOnMax": "example",
  "executionOnMin": "example",
  "expirationOnMax": "example",
  "expirationOnMin": "example",
  "externalId": "example",
  "filingIds": [
    "example"
  ],
  "licenseTypeEnums": [
    "exclusive"
  ],
  "limit": 0,
  "matterTypes": [
    "example"
  ],
  "organizationIds": [
    "example"
  ],
  "page": 0,
  "q": "example",
  "requestedOnMax": "example",
  "requestedOnMin": "example",
  "signatureOnMax": "example",
  "signatureOnMin": "example",
  "sortDirection": "ASC",
  "sortField": "example",
  "sourceEnums": [
    "admin"
  ],
  "statusLookupIds": [
    "example"
  ],
  "subTypeEnums": [
    "consulting"
  ],
  "terminatedOnMax": "example",
  "terminatedOnMin": "example",
  "typeEnums": [
    "assignment"
  ],
  "updatedByUserIds": [
    "example"
  ],
  "updatedOnMax": "example",
  "updatedOnMin": "example"
}
```