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

# RND Basic API

> Basic Reassigned Number Database API

# RND Basic API

The RND (Reassigned Number Database) Basic API provides a streamlined interface for checking if phone numbers have been reassigned using the FCC Reassigned Number Database.

## Endpoint

```
https://dataapi.dncscrub.com/v1.5/Data/RNDBasic
```

## Authentication

Include your API key in the `loginId` HTTP header:

```bash theme={null}
--header 'loginId: YOUR_API_KEY'
```

## Parameters

| Parameter     | Required | Description                                                            |
| ------------- | -------- | ---------------------------------------------------------------------- |
| `phoneNumber` | Yes      | 10-digit phone number (no leading 1 or +)                              |
| `date`        | Yes      | Consent date to check against                                          |
| `useSandbox`  | No       | Set to `true` to use sandbox mode for testing (returns random results) |
| `projId`      | No       | Project identifier for tracking purposes                               |

### Date Formats

The `date` parameter accepts multiple formats:

| Format       | Example      |
| ------------ | ------------ |
| `MM/DD/YYYY` | `09/29/2021` |
| `YYYY-MM-DD` | `2021-09-29` |
| `MM/DD/YY`   | `09/29/21`   |
| `YYYYMMDD`   | `20210929`   |

## Single Number Request (GET)

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

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

  ```csharp C# theme={null}
  using (var client = new HttpClient())
  {
      client.DefaultRequestHeaders.Add("loginId", "YOUR_API_KEY");
      var response = await client.GetStringAsync(
          "https://dataapi.dncscrub.com/v1.5/Data/RNDBasic?phoneNumber=7075276405&date=20211109"
      );
  }
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "PhoneNumber": "7075276405",
  "IsReassigned": false,
  "HasSafeHarbor": true,
  "IsSandBox": false
}
```

## Multiple Number Request (POST)

For checking multiple numbers, use HTTP POST with a JSON body:

```bash theme={null}
curl --location --request POST \
  'https://dataapi.dncscrub.com/v1.5/Data/RNDBasic' \
  --header 'loginId: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "Data": [
      { "phoneNumber": "7075276405", "date": "20211109" },
      { "phoneNumber": "5039367187", "date": "20211109" }
    ],
    "UseSandbox": false,
    "ProjId": "Demo"
  }'
```

### Response

```json theme={null}
[
  {
    "PhoneNumber": "7075276405",
    "IsReassigned": false,
    "HasSafeHarbor": true,
    "IsSandBox": false
  },
  {
    "PhoneNumber": "5039367187",
    "IsReassigned": false,
    "HasSafeHarbor": true,
    "IsSandBox": false
  }
]
```

## Response Fields

| Field           | Type         | Description                                                                   |
| --------------- | ------------ | ----------------------------------------------------------------------------- |
| `PhoneNumber`   | String       | The phone number checked                                                      |
| `IsReassigned`  | Boolean/null | `true` = reassigned, `false` = not reassigned, `null` = unknown               |
| `HasSafeHarbor` | Boolean      | `true` if FCC safe harbor exemption may be available                          |
| `IsSandBox`     | Boolean      | `true` if response was generated in sandbox mode, `false` for production data |

## Rate Limits

| Limit               | Value |
| ------------------- | ----- |
| Numbers per request | 1,000 |

## Use Cases

* Basic reassignment detection
* Cost-effective compliance checking
* Safe harbor verification

## Getting Started

Contact our support team to:

1. Get your API credentials
2. Access Postman collection samples

## Related Documentation

<CardGroup cols={2}>
  <Card title="Reassigned Authority Plus API" icon="shield-check" href="/api-reference/reassigned/authority-plus">
    Enhanced reassigned number API with carrier data and extended historical coverage
  </Card>

  <Card title="Test Numbers" icon="flask" href="/api-reference/reassigned/test-numbers">
    Test phone numbers for development
  </Card>
</CardGroup>