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

# Reassigned Authority Plus (GET)

> Reassigned Authority Plus - Enhanced reassigned number check combining carrier and FCC data

Reassigned Authority Plus (Enhanced RND) combines CCC's authoritative carrier data with the FCC Reassigned Number Database to provide the most accurate reassignment determination available.

<Note>
  **Why Authority Plus?** The FCC Reassigned Number Database only has data from
  January 27, 2021. CCC's carrier data goes back to **July 2018** and is updated
  **daily** (vs monthly for FCC data).
</Note>

## Request

### Headers

<ParamField header="loginId" type="string" required>
  Your API Key (LoginId from your DNCScrub account)
</ParamField>

### Query Parameters

<ParamField query="phoneNumber" type="string" required>
  10-digit North American phone number (without leading 1 or +)
</ParamField>

<ParamField query="date" type="string" required>
  Consent date to check reassignment against. Supported formats: `MM/DD/YYYY`,
  `YYYY-MM-DD`, `MM/DD/YY`, or `YYYYMMDD`
</ParamField>

<ParamField query="useSandbox" type="boolean" default="false">
  (Optional) Set to `true` to use sandbox mode for testing (returns random
  results)
</ParamField>

<ParamField query="projId" type="string">
  Project identifier for tracking purposes
</ParamField>

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl --location --request GET \
    'https://dataapi.dncscrub.com/v1.5/Data/EnhancedRND?phoneNumber=7075276405&date=20211109' \
    --header 'loginId: YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://dataapi.dncscrub.com/v1.5/Data/EnhancedRND?phoneNumber=7075276405&date=20211109",
    {
      method: "GET",
      headers: { loginId: "YOUR_API_KEY" },
    }
  );
  const data = await response.json();
  console.log(data);
  ```

  ```csharp C# theme={null}
  using (var client = new HttpClient())
  {
      client.DefaultRequestHeaders.Add("loginId", "YOUR_API_KEY");

      var url = "https://dataapi.dncscrub.com/v1.5/Data/EnhancedRND?phoneNumber=7075276405&date=20211109";
      var response = await client.GetStringAsync(url);
      Console.WriteLine(response);
  }
  ```
</CodeGroup>

<ResponseExample>
  ```json Response theme={null}
  {
    "PhoneNumber": "7075276405",
    "IsReassigned": false,
    "HasSafeHarbor": true,
    "CCCIsReassigned": false,
    "IsSandBox": false
  }
  ```
</ResponseExample>

## Response Fields

<ResponseField name="PhoneNumber" type="string">
  The phone number that was checked
</ResponseField>

<ResponseField name="IsReassigned" type="boolean | null">
  **Combined result** from FCC Reassigned Number Database plus CCC's carrier
  data. This is the field you should use to determine if to place the call: -
  `true` - Reassigned. **Do not call.** - `false` - Not reassigned. Safe to
  call. - `null` - Insufficient information from both sources.
</ResponseField>

<ResponseField name="HasSafeHarbor" type="boolean">
  `true` if an FCC safe harbor exemption may be available
</ResponseField>

<ResponseField name="CCCIsReassigned" type="boolean | null">
  Result from CCC's internal carrier data only. **For informational purposes
  only** - use `IsReassigned` for your call decision.
</ResponseField>

<ResponseField name="IsSandBox" type="boolean">
  `true` if the response was generated in sandbox mode (test data), `false` for production data.
</ResponseField>

## Error Responses

| Status           | Description                                                                      |
| ---------------- | -------------------------------------------------------------------------------- |
| 400 Bad Request  | Invalid phone number format, invalid date format, or missing required parameters |
| 401 Unauthorized | Invalid or missing API key                                                       |

## Data Source Comparison

| Feature          | FCC RND                       | CCC Carrier Data      | Enhanced RND (Combined) |
| ---------------- | ----------------------------- | --------------------- | ----------------------- |
| Data Start Date  | Jan 27, 2021                  | July 2018             | July 2018               |
| Update Frequency | Monthly                       | Daily                 | Daily                   |
| Coverage         | All carriers reporting to FCC | Major mobile carriers | Best of both            |

## Processing the Response

```javascript theme={null}
const result = await response.json();

// Always use IsReassigned for call decisions (combined result)
if (result.IsReassigned === true) {
  console.log("DO NOT CALL - Number has been reassigned");
} else if (result.IsReassigned === false) {
  console.log("Safe to call");

  if (result.HasSafeHarbor) {
    console.log("FCC Safe Harbor protection available");
  }
} else {
  console.log("Unable to determine - insufficient data");
}

// CCCIsReassigned is for informational/debugging purposes
console.log(`CCC internal data says: ${result.CCCIsReassigned}`);
```