> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://ixopay.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://ixopay.ferndocs.com/_mcp/server.

# Tokenize

**Tokenize** is used to tokenize a data element such as a Social Security number or health ID number.

> **Heads-up!**
>
> **TokenEx API v1** has been deprecated and is now in break/fix mode. All new enhancements are being added to [API v2](https://documentation.ixopay.com/modules/api/tokenex/token-servicesv-2-tokenize).

**URI:** [https://test-api.tokenex.com/TokenServices.svc/REST/Tokenize](https://test-api.tokenex.com/TokenServices.svc/REST/Tokenize)

**Request Parameters**

| Parameter   | Type   | Description                                                                                                                          |
| ----------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| APIKey      | string | See [Authentication](https://documentation.ixopay.com/modules/docs/tokenex/authentication)                                           |
| TokenExID   | string | Your TokenEx ID                                                                                                                      |
| Data        | string | Sensitive Data to Tokenize                                                                                                           |
| TokenScheme | Enum   | JSON Value or Enum name, See [Standard Token Schemes](https://documentation.ixopay.com/modules/docs/tokenex/universal-token-schemes) |

```json
{
  "APIKey": "YourAPIKey",
  "TokenExID": "YourTokenExID",
  "Data": "5454545454545454",
  "TokenScheme": 1
}
```

**Response Parameters**

| Parameter       | Type   | Description                                                          |
| --------------- | ------ | -------------------------------------------------------------------- |
| Token           | string | The token as generated by TokenEx that references the sensitive data |
| Success         | bool   | Indicator if the result was successful or not                        |
| ReferenceNumber | string | Reference number for the TokenEx transaction                         |
| Error           | string | Error Code and human-readable description                            |

```json
{
  "Error": "",
  "ReferenceNumber": "15102913382030662954",
  "Success": true,
  "Token": "545454587415454"
}
```