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

# Matter

> Returns a matter.

<RequestExample>
  ```graphql Request [expandable] theme={null}
  query GetMatter($id: MatterGID!) {
    matter(id: $id) {
      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
            corporations {
              id
              name
              refinanceOwnershipStatus
            }
            ... 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
            corporations {
              id
              name
              refinanceOwnershipStatus
            }
            ... on RefinanceParticipant {
              ownershipStatus
            }
            ... on TransactionParticipant {
              transactionSide
            }
          }
          representors {
            corporationSigningOfficer
            firstName
            fullName
            id
            lastName
            primaryClient
            representation
            represented
            representsPrimaryClient
            traits
            corporations {
              id
              name
              refinanceOwnershipStatus
            }
            ... 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
            corporations {
              id
              name
              refinanceOwnershipStatus
            }
            ... 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
      }
    }
  }
  ```

  ```graphql Variables theme={null}
  {
    "id": "gid://ownright/Matter/1"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": {
      "matter": {
        "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"
              ],
              "corporations": [
                {
                  "id": "gid://ownright/Object/1",
                  "name": "example-name",
                  "refinanceOwnershipStatus": "BEING_REMOVED_FROM_TITLE"
                }
              ],
              "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"
                ],
                "corporations": [
                  {
                    "id": "gid://ownright/Object/1",
                    "name": "example-name",
                    "refinanceOwnershipStatus": "BEING_REMOVED_FROM_TITLE"
                  }
                ],
                "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"
                ],
                "corporations": [
                  {
                    "id": "gid://ownright/Object/1",
                    "name": "example-name",
                    "refinanceOwnershipStatus": "BEING_REMOVED_FROM_TITLE"
                  }
                ],
                "ownershipStatus": "BEING_REMOVED_FROM_TITLE",
                "transactionSide": "PURCHASER"
              }
            ]
          }
        ],
        "saleAmount": {
          "amount": "100.00",
          "currencyCode": "CAD"
        }
      }
    }
  }
  ```
</ResponseExample>

## Query field

`matter`

### Arguments

<ParamField path="id" type="MatterGID!" required>
  The identifier of the matter to find.
</ParamField>

### Return fields

<ResponseField name="matter" type="Matter">
  Returns a matter.

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

      <Expandable title="properties">
        <ResponseField name="contact" type="BusinessContact!" required>
          The contact for the business.
        </ResponseField>

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

        <ResponseField name="partnerAccountLinked" type="Boolean!" required>
          Whether or not the contact has a partner account linked.
        </ResponseField>

        <ResponseField name="partnerNotificationsMuted" type="Boolean!" required>
          Whether the partner has muted notifications for the matter or not.
        </ResponseField>
      </Expandable>
    </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>

### 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.
* [`MatterGID`](/partner-api/reference/members/scalars/matter-gid) (scalar) — A global identifier for a matter object (ex. Transaction) in format of 'gid://ownright/{MatterKind}/ID'.
* [`NotificationDeliveryMechanism`](/partner-api/reference/members/enums/notification-delivery-mechanism) (enum) — Possible types of delivery mechanisms to deliver a notification.
