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

# Mock Credit Report

> Get a mock credit report for testing purposes

## Overview

Returns a deterministic mock credit report for testing your integration. The report contains realistic mock data structure identical to production responses.

<Warning>
  ⚠️ **SANDBOX**: This endpoint returns mock data for testing only. Do not use for production decisions.
</Warning>

## Path Parameters

<ParamField path="address" type="string" required>
  Any Ethereum address (e.g., `0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17`)
</ParamField>

## Response

The response format is identical to the production `/api/v2/report/address/{address}` endpoint.

<ResponseField name="address" type="string">
  The input Ethereum address
</ResponseField>

<ResponseField name="score" type="object">
  Mock credit score summary
</ResponseField>

<ResponseField name="assets" type="object">
  Mock asset holdings
</ResponseField>

<ResponseField name="defi" type="object">
  Mock DeFi positions
</ResponseField>

<ResponseField name="activity" type="object">
  Mock transaction activity
</ResponseField>

<ResponseField name="sandbox" type="boolean">
  Always `true` for sandbox responses
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.credprotocol.com/api/v2/sandbox/report/address/0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.credprotocol.com/api/v2/sandbox/report/address/0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17',
    {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    }
  );

  const report = await response.json();
  console.log(report.report.summary.total_asset_usd);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.credprotocol.com/api/v2/sandbox/report/address/0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17',
      headers={'Authorization': 'Bearer YOUR_API_KEY'}
  )

  report = response.json()
  print(report['report']['summary']['total_asset_usd'])
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17",
    "score": {
      "value": 723,
      "classification": "Good"
    },
    "assets": {
      "total_value_usd": 50000.00,
      "tokens": [
        {
          "symbol": "ETH",
          "name": "Ethereum",
          "balance": "10.5",
          "value_usd": 35000,
          "chain_id": 1
        },
        {
          "symbol": "USDC",
          "name": "USD Coin",
          "balance": "15000",
          "value_usd": 15000,
          "chain_id": 1
        }
      ],
      "nfts": [
        {
          "name": "Mock NFT #1234",
          "collection": "Mock Collection",
          "chain_id": 1
        }
      ]
    },
    "defi": {
      "protocols": [
        {
          "name": "Mock Protocol",
          "supplied": 10000,
          "borrowed": 0,
          "chain_id": 1
        }
      ],
      "total_supplied": 10000,
      "total_borrowed": 0
    },
    "activity": {
      "first_transaction": "2021-01-01T00:00:00Z",
      "total_transactions": 500,
      "active_chains": [1, 137]
    },
    "sandbox": true,
    "cached": false,
    "timestamp": "2024-01-15T10:30:00Z"
  }
  ```
</ResponseExample>

## Performance

* **Response Time**: Instant (no blockchain queries)
* **Caching**: Mock data is deterministic, no caching needed
* **Rate Limits**: Standard rate limits apply
* **Quota**: Does not count against your API quota