> ## 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 (GET)

> Check if a phone number has been reassigned since a given consent date

Check if a phone number has been reassigned since a given consent date using the TCPA Authority API. This API uses authoritative data provided directly from carriers.

<Note>
  The date input should be the consent date the customer gave the calling party
  consent to be called. If `IsReassigned` returns `true`, **do not call the
  number**.
</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>

## Example Request

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

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://dataapi.dncscrub.com/v1.5/Data/TCPAAuthority?phoneNumber=7075276405&date=20210209",
    {
      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/TCPAAuthority?phoneNumber=7075276405&date=20210209";
      var response = await client.GetStringAsync(url);
      Console.WriteLine(response);
  }
  ```
</CodeGroup>

<ResponseExample>
  ```json Response theme={null}
  {
    "PhoneNumber": "7075276405",
    "IsReassigned": false,
    "IsValid": true,
    "LineType": "Landline",
    "Carrier": "AT&T California",
    "Locale": "Santa Rosa",
    "Region": "CA",
    "Country": "US",
    "TZ": "America/Los_Angeles",
    "UTCOffset": "-420"
  }
  ```
</ResponseExample>

## Response Fields

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

<ResponseField name="IsReassigned" type="boolean | null">
  Indicates if the phone was reassigned after the consent date: - `true` -
  Reassigned after the date. **Do not call.** - `false` - Not reassigned. Safe
  to call. - `null` - Insufficient information to determine reassignment status.
</ResponseField>

<ResponseField name="IsValid" type="boolean">
  `true` if the phone number is valid and callable, `false` if not valid
</ResponseField>

<ResponseField name="LineType" type="string">
  Type of phone line: `Wireless`, `VoIP`, `Landline`, `Paging`, or `Unknown`
</ResponseField>

<ResponseField name="Carrier" type="string">
  Original carrier the phone number was assigned to
</ResponseField>

<ResponseField name="Locale" type="string">
  City based on original phone number assignment
</ResponseField>

<ResponseField name="Region" type="string">
  State/region based on original phone number assignment
</ResponseField>

<ResponseField name="Country" type="string">
  Two-digit ISO country code
</ResponseField>

<ResponseField name="TZ" type="string">
  Timezone in ISO IANA format (e.g., `America/Los_Angeles`)
</ResponseField>

<ResponseField name="UTCOffset" type="string">
  UTC offset in minutes. Use this to calculate the local time at the phone
  number.
</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                                                       |
| 403 Forbidden    | Account not authorized for this API or insufficient credits                      |

## Processing the Response

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

if (result.IsReassigned === true) {
  console.log("DO NOT CALL - Number has been reassigned");
} else if (result.IsReassigned === false) {
  console.log("Safe to call - Number has not been reassigned");
  console.log(`Line type: ${result.LineType}`);
  console.log(`Carrier: ${result.Carrier}`);
} else {
  console.log("Insufficient data to determine reassignment status");
}
```