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

# Check Status by Reference

> Check internet top-up status using custom reference

## Overview

Track internet top-up status using your custom reference from the send request.

## Path Parameters

<ParamField path="ref" type="string" required>
  Your custom reference from `/internet/send`
</ParamField>

## Response

Identical to [Check by ID](/en/api-reference/internet/check-by-id). Returns top-up object with status, card code (when fulfilled), and transaction details.

## Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.oneclickdz.com/v3/internet/check-ref/internet-order-001 \
    -H "X-Access-Token: YOUR_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const ref = "internet-order-001";
  const response = await fetch(
    `https://api.oneclickdz.com/v3/internet/check-ref/${ref}`,
    { headers: { "X-Access-Token": "YOUR_API_KEY" } }
  );
  ```

  ```python Python theme={null}
  response = requests.get(
      f'https://api.oneclickdz.com/v3/internet/check-ref/{ref}',
      headers={'X-Access-Token': 'YOUR_API_KEY'}
  )
  ```

  ```php PHP theme={null}
  <?php
  $ref = 'internet-order-001';
  $ch = curl_init("https://api.oneclickdz.com/v3/internet/check-ref/{$ref}");
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-Access-Token: YOUR_API_KEY']);
  $response = curl_exec($ch);
  ?>
  ```
</CodeGroup>

## Related

<Card title="Check by ID" href="/en/api-reference/internet/check-by-id">
  Full status documentation
</Card>