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

# Using the Sandbox Data and API

> The sandbox environment provides a controlled testing ground with predefined test data to help you validate your integration. While it closely mirrors the production environment, there are some key differences you should be aware of.

<Info>
  Make sure to review the [available test data](/docs/v1/api/guide-to-the-api/getting-started/test-data) before starting your integration. The test data covers various scenarios to help you validate different use cases.
</Info>

## Key Testing Guidelines

<AccordionGroup>
  <Accordion title="Name Matching Rules">
    * Family name matching is the primary identifier in sandbox mode
    * Matching is case-insensitive
    * Example: "Smith", "SMITH", and "smith" are treated as equivalent
  </Accordion>

  <Accordion title="Automatic Pass Feature">
    To force a successful verification for any test subject:

    ```plaintext theme={null}
    Set middle_name = "passall"
    ```
  </Accordion>

  <Accordion title="Special Result Types">
    The sandbox supports different verification outcomes based on test data markers:

    <CardGroup cols={2}>
      <Card title="Basic Checks" icon="check">
        * CLEAR: Clean record
        * PEP: Politically Exposed Person
        * SANCTION: Sanctions list match
        * FRAUD: Fraud indicators present
      </Card>

      <Card title="Advanced Checks" icon="code-branch">
        Records marked as **SKIP** will fetch detailed results from an external test service, providing comprehensive response data.
      </Card>
    </CardGroup>
  </Accordion>
</AccordionGroup>

## Response Types Example

<CodeGroup>
  ```json Sample CLEAR Response theme={null}
  {
    "status": "clear",
    "verification_id": "ver_123456789",
    "created_at": "2023-01-01T00:00:00Z"
  }
  ```

  ```json Sample PEP Response theme={null}
  {
    "status": "flagged",
    "verification_id": "ver_123456789",
    "created_at": "2023-01-01T00:00:00Z",
    "flags": ["PEP"],
    "details": {
      "risk_level": "medium",
      "position": "Local Government Official"
    }
  }
  ```
</CodeGroup>

<Callout icon="star" color="#3DD892" iconType="regular">
  For more advanced testing scenarios and error simulation, check out our guide on [Forcing Errors in Test Scenarios](/docs/v1/api/guide-to-the-api/using-the-sandbox/forcing-errors-in-test-scenarios).
</Callout>