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

# Fetching matter details

> An overview of how you can fetch details on matters you have access to

To retrieve information about a real estate transaction (a “matter”), you can query our
GraphQL API using either the `matter` query (for a specific matter) or the `matters`
query (to retrieve a list).

## 🔍 Fetching a specific matter

Use the `matter(id: MatterGID!)` query to retrieve details about a single matter.

```graphql Request theme={null}
query GetMatterDetails {
  matter(id: "gid://ownright/Transaction/1") {
    matter {
      id
      ... on Transaction {
        status
        # ... other fields
      }
    }
  }
}
```

**Sample response**:

```graphql Response theme={null}
{
  "data": {
    "matter": {
      "id": "gid://ownright/Transaction/1",
      "status": "CLOSING_IN_PROGRESS"
    }
  }
}
```

## 📋 Fetching multiple matters

If you don’t know the matter ID or want to browse multiple matters,
you can use the matters query to list them.

```graphql Request theme={null}
query ListMatters {
  matters(first: 10) {
    edges {
      node {
        id
        ... on Transaction {
          status
          # ... other fields
        }
      }
    }
  }
}
```

This query retrieves the first 10 matters, along with their status.

## Next steps

<CardGroup cols={2}>
  <Card title="Receiving webhooks on referral updates" icon="bell" href="/partner-api/guides/receiving-webhooks-on-referral-updates">
    Get automatic updates when referral statuses change.
  </Card>

  <Card title="Receiving webhooks on matter updates" icon="bell" href="/partner-api/guides/receiving-webhooks-on-matter-updates">
    Get automatic updates when matter statuses change.
  </Card>
</CardGroup>