> ## 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 referral details

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

To retrieve information about a referral, you can query our
GraphQL API using either the `referral` query (for a specific referral) or the `referrals`
query (to retrieve a list).

## 🔍 Fetching a specific referral

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

```graphql Request theme={null}
query GetReferralDetails {
  referral(id: "gid://ownright/Referral/1") {
    referral {
      id
      status
      # ... other fields
    }
  }
}
```

**Sample response**:

```graphql Response theme={null}
{
  "data": {
    "referral": {
      "id": "gid://ownright/Referral/1",
      "status": "OPEN"
    }
  }
}
```

## 📋 Fetching multiple referrals

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

```graphql Request theme={null}
query ListReferrals {
  referrals(first: 10) {
    edges {
      node {
        id
        status
        # ... other fields
      }
    }
  }
}
```

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

## Next steps

<CardGroup cols={2}>
  <Card title="Fetching matter details" icon="gavel" href="/partner-api/guides/fetching-matter-details">
    Track the progress of your client's legal transaction.
  </Card>

  <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>
</CardGroup>