# API Reference
source: https://developer.mastercard.com/consumer-clarity/documentation/api-reference/index.md

## API Updates {#api-updates}

We regularly make updates to the Consumer Clarity and Smart Subscriptions APIs to improve both performance and the overall user experience. Before you check out the [API specification](https://developer.mastercard.com/consumer-clarity/documentation/api-reference/index.md#apis) details below, you can review any recent or upcoming changes to the API at one of these articles:

* [Recent API Updates](https://developer.mastercard.com/consumer-clarity/documentation/release-history/index.md#recent-api-updates)
* [Upcoming API Updates](https://developer.mastercard.com/consumer-clarity/documentation/announcements/index.md#upcoming-api-updates)

### Versionless API {#versionless-api}

A versionless API is one that remains backwards compatible as new features or enhancements are added. Using a versionless API is a critical part of how we designed Ethoca Consumer Clarity as it allows for faster and more seamless ways for new features or improvements to be added without impacting existing integrations or end-user experiences.

The term *versionless API* doesn't mean there are no versions of the API. Instead, it refers to the fact that the API doesn't require customers to manage traditional version upgrades to avoid their integration from being broken upon a new release.

There might be times when updates to the API introduce the need for customers to make changes to their integration, such as removing a data field. But these instances are very rare and would be communicated well in advance of the change taking place.

## Environment Domains {#environment-domains}

* Sandbox
* Production

```Sandbox
https://sandbox.api.ethocaweb.com/ethoca
```

```Production
https://api.ethocaweb.com/ethoca
```

## APIs {#apis}

The API requests below shows example data for each individual field. Test cases are available to use in the sandbox, which include sets of request data that return expected responses. Contact your [Ethoca Customer Delivery Team](mailto:customerdelivery@ethoca.com) for details.

API Specification: `https://static.developer.mastercard.com/content/consumer-clarity/swagger/consumer-clarity-api-spec.yaml`


API Specification: `https://static.developer.mastercard.com/content/consumer-clarity/swagger/clarity-subscription-actions.yaml`

Note: When troubleshooting API response issues with your [Ethoca Customer Success team](mailto:customerservice@ethoca.com), provide them with the `recordId`. The last two digits of the `recordId` indicate the sequence of the call that is in question.

### Error handling {#error-handling}

See [Code and Formats](https://developer.mastercard.com/consumer-clarity/documentation/code-and-formats/index.md) for detailed information about error response handling for the Consumer Clarity and Smart Subscriptions APIs.