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

# Reference - Sandbox APIs

***

title: Reference - Sandbox APIs
subtitle: Reference information for the Sandbox APIs
slug: sandbox-apis-reference
category: api
parentDocSlug: sandbox-apis
order: 2
hidden: False
-------------

## Endpoints

URLs for our Sandbox APIs follow this structure: `https://sandbox.api.peopledatalabs.com/<path>`, where `<path>` is one of the following:

| API                                                                                                | Sandbox Endpoint Path |
| -------------------------------------------------------------------------------------------------- | --------------------- |
| [Person Enrichment](https://docs.peopledatalabs.com/docs/reference-person-enrichment-api#endpoint) | `v5/person/enrich`    |
| [Person Search](https://docs.peopledatalabs.com/docs/reference-person-search-api#endpoint)         | `v5/person/search`    |
| [Person Identify](https://docs.peopledatalabs.com/docs/identify-api-reference#endpoint)            | `v5/person/identify`  |
| [Bulk Person Enrichment API](https://docs.peopledatalabs.com/docs/bulk-enrichment-api)                                              | `v5/person/bulk`      |
| [Company Enrichment](https://docs.peopledatalabs.com/docs/reference-company-enrichment-api)        | `v5/company/enrich`   |
| [Company Search](https://docs.peopledatalabs.com/docs/reference-company-search-api)                | `v5/company/search`   |

For example, the endpoint for the Sandbox Person Enrichment API is `https://sandbox.api.peopledatalabs.com/v5/person/enrich`.

## SDK Usage

To access the Sandbox API endpoints within our SDKs, use any of the following language-specific strategies:

```python Python3 SDK
# Set sandbox to True when creating a client
CLIENT = PDLPY(
    api_key="YOUR API KEY",
    # Use Sandbox API
    sandbox=True,
)
```

```javascript
// Set sandbox to true in the parameters JSON object
const params = {
  email: "irussell@example.org",
  min_likelihood: 6,
  // Use Sandbox API
  sandbox: true
}
```

```ruby
# Use Sandbox API
Peopledatalabs.sandbox = true
```

```go
// Include extra imports
import (
    pdl "github.com/peopledatalabs/peopledatalabs-go"
    "github.com/peopledatalabs/peopledatalabs-go/api"
    pdlmodel "github.com/peopledatalabs/peopledatalabs-go/model"
)

// Set Sandbox to true in ClientOptions() when creating a client
client := pdl.New(apiKey,
                      api.ClientOptions(func(c *api.Client) {
                                    c.Sandbox = true
                      }))
```

See [Sandbox examples](https://docs.peopledatalabs.com/docs/sandbox-apis-examples) for specific usage.

## Billing and Access

The Sandbox APIs are free endpoints and do not consume credits. All plans have access.

## Rate Limiting

The default rate limit for all customers is five calls per minute.

## Input Parameters

The input parameters for each Sandbox API endpoint are identical to the input parameters for the corresponding production endpoint. Here are the input parameters that each Sandbox endpoint supports:

| Sandbox API Endpoint   | Input Parameters                                                                                          | Detailed Reference                                                                                           |
| ---------------------- | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| Person Enrichment      | [Input Parameters](https://docs.peopledatalabs.com/docs/reference-person-enrichment-api#input-parameters) | [Detailed Reference](https://docs.peopledatalabs.com/docs/input-parameters-person-enrichment-api)            |
| Person Search          | [Input Parameters](https://docs.peopledatalabs.com/docs/reference-person-search-api#input-parameters)     | [Detailed Reference](https://docs.peopledatalabs.com/docs/input-parameters-person-search-api)                |
| Person Identify        | [Input Parameters](https://docs.peopledatalabs.com/docs/identify-api-reference#input-parameters)          | [Detailed Reference](https://docs.peopledatalabs.com/docs/identify-api-input-parameters)                     |
| Bulk Person Enrichment | [Input Parameters](https://docs.peopledatalabs.com/docs/bulk-enrichment-api#request-format)               | [Detailed Reference](https://docs.peopledatalabs.com/docs/input-parameters-person-enrichment-api)            |
| Company Enrichment     | [Input Parameters](https://docs.peopledatalabs.com/docs/input-parameters-company-enrichment-api)          | [Detailed Reference](https://docs.peopledatalabs.com/docs/reference-company-enrichment-api#input-parameters) |
| Company Search         | [Input Parameters](https://docs.peopledatalabs.com/docs/input-parameters-company-search-api)              | [Detailed Reference](https://docs.peopledatalabs.com/docs/reference-company-search-api#input-parameters)     |

## Output Response

All Sandbox API endpoints return data that follows the same response structure as the corresponding production endpoint. Here are the output responses that each Sandbox endpoint supports:

> 🚧 Synthetic data only!
>
> All Sandbox API endpoints return only artificial data in their responses. For more information, see the Full Sandbox Datasets listed below.

| Sandbox API Endpoint   | Output Response                                                                                  | Detailed Reference                                                                                          |
| ---------------------- | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------- |
| Person Enrichment      | [Output Response](https://docs.peopledatalabs.com/docs/reference-person-enrichment-api#response) | [Detailed Reference](https://docs.peopledatalabs.com/docs/output-response-person-enrichment-api)            |
| Person Search          | [Output Response](https://docs.peopledatalabs.com/docs/reference-person-search-api#response)     | [Detailed Reference](https://docs.peopledatalabs.com/docs/output-response-person-search-api)                |
| Person Identify        | [Output Response](https://docs.peopledatalabs.com/docs/identify-api-reference#output-response)   | [Detailed Reference](https://docs.peopledatalabs.com/docs/identify-api-output-response)                     |
| Bulk Person Enrichment | [Output Response](https://docs.peopledatalabs.com/docs/bulk-enrichment-api#response-format)      | [Detailed Reference](https://docs.peopledatalabs.com/docs/output-response-person-enrichment-api)            |
| Company Enrichment     | [Output Response](https://docs.peopledatalabs.com/docs/output-response-company-enrichment-api)   | [Detailed Reference](https://docs.peopledatalabs.com/docs/reference-company-enrichment-api#output-response) |
| Company Search         | [Output Response](https://docs.peopledatalabs.com/docs/output-response-company-search-api)       | [Detailed Reference](https://docs.peopledatalabs.com/docs/reference-company-search-api#output-response)     |

<br />

## Datasets

<br />

| Full Sandbox Datasets                                                                                                                                      |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Person Sandbox Dataset](https://s3.console.aws.amazon.com/s3/buckets/pdl-prod-schema?prefix=34.1/sandbox/person/\&region=us-west-2\&bucketType=general)   |
| [Company Sandbox Dataset](https://s3.console.aws.amazon.com/s3/buckets/pdl-prod-schema?prefix=34.1/sandbox/company/\&region=us-west-2\&bucketType=general) |

*Updated as of 34.1*