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

# Matters

> Returns all matters the business contact is involved in.

<RequestExample>
  ```graphql Request [expandable] theme={null}
  query GetMatters($after: String, $before: String, $first: Int, $last: Int) {
    matters(after: $after, before: $before, first: $first, last: $last) {
      nodes {
        id
        shortId
        test
        currentUserMatterBusinessContact {
          id
          partnerAccountLinked
          partnerNotificationsMuted
          contact {
            email
            faxNumber
            firstName
            frontUserIdHash
            fullName
            id
            lastName
            notificationDeliveryMechanisms
            phoneNumber
          }
        }
        ... on PurchaseTransaction {
          agreementDate
          closingDate
          depositAmount {
            amount
            currencyCode
          }
          milestones {
            completedAt
            description
            handle
            oneliner
            status
            title
          }
          property {
            id
            type
            address {
              city
              country
              latitude
              longitude
              mapImageUrl
              postalCode
              province
              shortTitle
              street
              title
              unitNumber
            }
          }
          purchaseAmount {
            amount
            currencyCode
          }
          representedSide {
            name
            corporations {
              id
              name
              refinanceOwnershipStatus
            }
            participants {
              corporationSigningOfficer
              firstName
              fullName
              id
              lastName
              primaryClient
              representation
              represented
              representsPrimaryClient
              traits
              ... on RefinanceParticipant {
                ownershipStatus
              }
              ... on TransactionParticipant {
                transactionSide
              }
            }
          }
          status {
            state
            ... on PurchaseTransactionClosingInProgressStatus {
              closingActionItems {
                completedAt
                description
                expectedBy
                id
                state
                title
              }
              closingDateAmended
              closingStatus
            }
            ... on SaleTransactionClosingInProgressStatus {
              closingActionItems {
                completedAt
                description
                expectedBy
                id
                state
                title
              }
              closingDateAmended
              closingStatus
            }
          }
          type
        }
        ... on Refinance {
          closingDate
          commitmentDate
          corporations {
            id
            name
            refinanceOwnershipStatus
          }
          loans {
            id
            type
            lenders {
              id
              logoImageUrl
              name
              websiteUrl
            }
            principalAmount {
              amount
              currencyCode
            }
          }
          milestones {
            completedAt
            description
            handle
            oneliner
            status
            title
          }
          participants {
            corporationSigningOfficer
            firstName
            fullName
            id
            lastName
            ownershipStatus
            primaryClient
            representation
            represented
            representsPrimaryClient
            traits
            corporations {
              id
              name
              refinanceOwnershipStatus
            }
            representees {
              corporationSigningOfficer
              firstName
              fullName
              id
              lastName
              primaryClient
              representation
              represented
              representsPrimaryClient
              traits
              ... on RefinanceParticipant {
                ownershipStatus
              }
              ... on TransactionParticipant {
                transactionSide
              }
            }
            representors {
              corporationSigningOfficer
              firstName
              fullName
              id
              lastName
              primaryClient
              representation
              represented
              representsPrimaryClient
              traits
              ... on RefinanceParticipant {
                ownershipStatus
              }
              ... on TransactionParticipant {
                transactionSide
              }
            }
          }
          property {
            id
            type
            address {
              city
              country
              latitude
              longitude
              mapImageUrl
              postalCode
              province
              shortTitle
              street
              title
              unitNumber
            }
          }
          status {
            state
            ... on RefinanceClosingInProgressStatus {
              closingActionItems {
                completedAt
                description
                expectedBy
                id
                state
                title
              }
            }
          }
        }
        ... on SaleTransaction {
          agreementDate
          closingDate
          depositAmount {
            amount
            currencyCode
          }
          milestones {
            completedAt
            description
            handle
            oneliner
            status
            title
          }
          property {
            id
            type
            address {
              city
              country
              latitude
              longitude
              mapImageUrl
              postalCode
              province
              shortTitle
              street
              title
              unitNumber
            }
          }
          representedSide {
            name
            corporations {
              id
              name
              refinanceOwnershipStatus
            }
            participants {
              corporationSigningOfficer
              firstName
              fullName
              id
              lastName
              primaryClient
              representation
              represented
              representsPrimaryClient
              traits
              ... on RefinanceParticipant {
                ownershipStatus
              }
              ... on TransactionParticipant {
                transactionSide
              }
            }
          }
          saleAmount {
            amount
            currencyCode
          }
          status {
            state
            ... on PurchaseTransactionClosingInProgressStatus {
              closingActionItems {
                completedAt
                description
                expectedBy
                id
                state
                title
              }
              closingDateAmended
              closingStatus
            }
            ... on SaleTransactionClosingInProgressStatus {
              closingActionItems {
                completedAt
                description
                expectedBy
                id
                state
                title
              }
              closingDateAmended
              closingStatus
            }
          }
          type
        }
      }
      pageInfo {
        hasNextPage
        endCursor
      }
    }
  }
  ```

  ```graphql Variables theme={null}
  {
    "after": "example-after",
    "before": "example-before",
    "first": 10,
    "last": 10
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": {
      "matters": {
        "nodes": [
          {
            "id": "gid://ownright/Object/1",
            "shortId": "ABC-123",
            "test": true,
            "currentUserMatterBusinessContact": {
              "id": "gid://ownright/Object/1",
              "partnerAccountLinked": true,
              "partnerNotificationsMuted": true,
              "contact": {
                "email": "jane@example.com",
                "faxNumber": "+14165551234",
                "firstName": "Jane",
                "frontUserIdHash": "example-front-user-id-hash",
                "fullName": "example-full-name",
                "id": "gid://ownright/Object/1",
                "lastName": "Doe",
                "notificationDeliveryMechanisms": [
                  "EMAIL"
                ],
                "phoneNumber": "+14165551234"
              }
            },
            "agreementDate": "2025-06-15",
            "closingDate": "2025-06-15",
            "depositAmount": {
              "amount": "100.00",
              "currencyCode": "CAD"
            },
            "milestones": [
              {
                "completedAt": "2025-01-15T10:30:00Z",
                "description": "example-description",
                "handle": "ADJUSTMENTS_CONFIRMED",
                "oneliner": "example-oneliner",
                "status": "COMPLETED",
                "title": "123 Main St, Toronto"
              }
            ],
            "property": {
              "id": "gid://ownright/Object/1",
              "type": "CONDO",
              "address": {
                "city": "Toronto",
                "country": "CANADA",
                "latitude": 1,
                "longitude": 1,
                "mapImageUrl": "https://example.com",
                "postalCode": "M5V 1A1",
                "province": "ALBERTA",
                "shortTitle": "123 Main St, Toronto",
                "street": "123 Main St",
                "title": "123 Main St, Toronto",
                "unitNumber": "Suite 100"
              }
            },
            "purchaseAmount": {
              "amount": "100.00",
              "currencyCode": "CAD"
            },
            "representedSide": {
              "name": "PURCHASER",
              "corporations": [
                {
                  "id": "gid://ownright/Object/1",
                  "name": "example-name",
                  "refinanceOwnershipStatus": "BEING_REMOVED_FROM_TITLE"
                }
              ],
              "participants": [
                {
                  "corporationSigningOfficer": true,
                  "firstName": "Jane",
                  "fullName": "example-full-name",
                  "id": "gid://ownright/Object/1",
                  "lastName": "Doe",
                  "primaryClient": true,
                  "representation": "ESTATE_TRUSTEE",
                  "represented": true,
                  "representsPrimaryClient": true,
                  "traits": [
                    "BORROWER"
                  ],
                  "ownershipStatus": "BEING_REMOVED_FROM_TITLE",
                  "transactionSide": "PURCHASER"
                }
              ]
            },
            "status": {
              "state": "ABANDONED",
              "closingActionItems": [
                {
                  "completedAt": "2025-01-15T10:30:00Z",
                  "description": "example-description",
                  "expectedBy": "2025-01-15T10:30:00Z",
                  "id": "gid://ownright/Object/1",
                  "state": "COMPLETED",
                  "title": "123 Main St, Toronto"
                }
              ],
              "closingDateAmended": true,
              "closingStatus": "ACTIVE"
            },
            "type": "PURCHASE",
            "commitmentDate": "2025-06-15",
            "corporations": [
              {
                "id": "gid://ownright/Object/1",
                "name": "example-name",
                "refinanceOwnershipStatus": "BEING_REMOVED_FROM_TITLE"
              }
            ],
            "loans": [
              {
                "id": "gid://ownright/Object/1",
                "type": "BRIDGE_LOAN",
                "lenders": [
                  {
                    "id": "gid://ownright/Object/1",
                    "logoImageUrl": "https://example.com",
                    "name": "example-name",
                    "websiteUrl": "https://example.com"
                  }
                ],
                "principalAmount": {
                  "amount": "100.00",
                  "currencyCode": "CAD"
                }
              }
            ],
            "participants": [
              {
                "corporationSigningOfficer": true,
                "firstName": "Jane",
                "fullName": "example-full-name",
                "id": "gid://ownright/Object/1",
                "lastName": "Doe",
                "ownershipStatus": "BEING_REMOVED_FROM_TITLE",
                "primaryClient": true,
                "representation": "ESTATE_TRUSTEE",
                "represented": true,
                "representsPrimaryClient": true,
                "traits": [
                  "BORROWER"
                ],
                "corporations": [
                  {
                    "id": "gid://ownright/Object/1",
                    "name": "example-name",
                    "refinanceOwnershipStatus": "BEING_REMOVED_FROM_TITLE"
                  }
                ],
                "representees": [
                  {
                    "corporationSigningOfficer": true,
                    "firstName": "Jane",
                    "fullName": "example-full-name",
                    "id": "gid://ownright/Object/1",
                    "lastName": "Doe",
                    "primaryClient": true,
                    "representation": "ESTATE_TRUSTEE",
                    "represented": true,
                    "representsPrimaryClient": true,
                    "traits": [
                      "BORROWER"
                    ],
                    "ownershipStatus": "BEING_REMOVED_FROM_TITLE",
                    "transactionSide": "PURCHASER"
                  }
                ],
                "representors": [
                  {
                    "corporationSigningOfficer": true,
                    "firstName": "Jane",
                    "fullName": "example-full-name",
                    "id": "gid://ownright/Object/1",
                    "lastName": "Doe",
                    "primaryClient": true,
                    "representation": "ESTATE_TRUSTEE",
                    "represented": true,
                    "representsPrimaryClient": true,
                    "traits": [
                      "BORROWER"
                    ],
                    "ownershipStatus": "BEING_REMOVED_FROM_TITLE",
                    "transactionSide": "PURCHASER"
                  }
                ]
              }
            ],
            "saleAmount": {
              "amount": "100.00",
              "currencyCode": "CAD"
            }
          }
        ],
        "pageInfo": {
          "hasNextPage": true,
          "endCursor": "cursor_abc123"
        }
      }
    }
  }
  ```
</ResponseExample>

## Query field

`matters`

### Arguments

<ParamField path="after" type="String">
  Returns the elements in the list that come after the specified cursor.
</ParamField>

<ParamField path="before" type="String">
  Returns the elements in the list that come before the specified cursor.
</ParamField>

<ParamField path="first" type="Int">
  Returns the first *n* elements from the list.
</ParamField>

<ParamField path="last" type="Int">
  Returns the last *n* elements from the list.
</ParamField>

### Return fields

<ResponseField name="matters" type="MatterConnection!" required>
  Returns all matters the business contact is involved in.

  <Expandable title="properties">
    <ResponseField name="edges" type="[MatterEdge]">
      A list of edges.

      <Expandable title="properties">
        <ResponseField name="cursor" type="String!" required>
          A cursor for use in pagination.
        </ResponseField>

        <ResponseField name="node" type="Matter">
          The item at the end of the edge.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="nodes" type="[Matter]">
      A list of nodes.

      <Expandable title="properties">
        <ResponseField name="currentUserMatterBusinessContact" type="MatterBusinessContact">
          The currently authenticated matter business contact information (if any).
        </ResponseField>

        <ResponseField name="id" type="GID!" required>
          ID of the object.
        </ResponseField>

        <ResponseField name="shortId" type="String!" required>
          The matter's short identifier.
        </ResponseField>

        <ResponseField name="test" type="Boolean!" required>
          Whether the matter is a test matter or not.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="pageInfo" type="PageInfo!" required>
      Information to aid in pagination.

      <Expandable title="properties">
        <ResponseField name="endCursor" type="String">
          When paginating forwards, the cursor to continue.
        </ResponseField>

        <ResponseField name="hasNextPage" type="Boolean!" required>
          When paginating forwards, are there more items?
        </ResponseField>

        <ResponseField name="hasPreviousPage" type="Boolean!" required>
          When paginating backwards, are there more items?
        </ResponseField>

        <ResponseField name="startCursor" type="String">
          When paginating backwards, the cursor to continue.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

### Types

* [`BusinessContact`](/partner-api/reference/members/objects/business-contact) (object) — A business contact.
* [`E164PhoneNumber`](/partner-api/reference/members/scalars/e164-phone-number) (scalar) — A valid phone number string in the E.164 format.
* [`GID`](/partner-api/reference/members/scalars/gid) (scalar) — A global identifier for an object in the format of 'gid://ownright/ObjectType/ID'.
* [`Matter`](/partner-api/reference/members/interfaces/matter) (interface) — Represents a matter.
* [`MatterBusinessContact`](/partner-api/reference/members/objects/matter-business-contact) (object) — A business contact that is associated with a matter.
* [`MatterConnection`](/partner-api/reference/members/objects/matter-connection) (object) — The connection type for Matter.
* [`MatterEdge`](/partner-api/reference/members/objects/matter-edge) (object) — An edge in a connection.
* [`NotificationDeliveryMechanism`](/partner-api/reference/members/enums/notification-delivery-mechanism) (enum) — Possible types of delivery mechanisms to deliver a notification.
* [`PageInfo`](/partner-api/reference/members/objects/page-info) (object) — Information about pagination in a connection.
