---
schema_version: "1"
id: 559678f7f48b723f0d11223e82f67974a0e4b8c8946bc261e289dd16747eaa33
title: Service | Get Case By Case Number
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/copilot_actions_ref_get_cases_by_case_number.md
canonical_url: https://help.salesforce.com/s/articleView?id=ai.copilot_actions_ref_get_cases_by_case_number.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 1fbc53b1195f532d40ca5ff4e0e8963ad422c5eb3d1614d054b31f4d41700ff1
description: Returns a case associated with a given contact record and case number.
products:
  - Agentforce
  - Cross Cloud
release: "264"
---
# Service | Get Case By Case Number

Returns a case associated with a given contact record and case number.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions with Foundations, or <strong>Agentforce 1</strong> or <strong>Einstein 1</strong> Editions</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
      <colgroup>
        <col style="width:50%">
        <col style="width:50%">
      </colgroup>
      <thead class="slds-text-title_caps ">
        <tr class="">
          <th scope="col" class="slds-cell-wrap" style="text-align:center;vertical-align:top;" id="d54083e77">User Permissions Needed</th>
          <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d54083e80">&nbsp;</th>
        </tr>
      </thead>
      <tbody>
        <tr class="">
          <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;" headers="d54083e77 d54083e80 ">See <a href="https://help.salesforce.com/s/articleView?id=ai.agent_actions_common_perms.htm&amp;type=5&amp;language=en_US" target="_blank">Common User Access for Standard Agent
              Actions</a>.</td>

        </tr>
      </tbody>
    </table>

## Action Details

To use this action, customize it according to your business’s security standards. We recommend configuring your agent to confirm the requester's identity before completing this action on their behalf. See [Maintain Trust with Agentforce Actions](https://help.salesforce.com/s/articleView?id=service.service_agentforce_trusted_private_actions.htm&type=5&language=en_US).

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small "><colgroup><col style="width:50%"> <col style="width:50%"></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">API Name</td><td class="slds-cell-wrap" style="vertical-align:top;">GetCaseByCaseNumber</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Reference Action Type</td><td class="slds-cell-wrap" style="vertical-align:top;">Flow</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Reference Action</td><td class="slds-cell-wrap" style="vertical-align:top;">Get Case By Case Number</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Does this action execute one or more prompt templates?</td><td class="slds-cell-wrap" style="vertical-align:top;">No</td></tr></tbody></table>