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

# Introduction to the V1 API (Legacy)

> This page refers to our Legacy API, V1.

<Warning>
  The V1 API is **deprecated**. Starting November 1st 2025, no support will be provided for the V1 API and it will be **removed by April 2026**. No new features nor functionality will be added to the V1 API. Please use the [V2 Verify API](/verify/v2/documentation/introduction) instead. For more information refer to the [V2 Migration Guide](/verify/v2/documentation/v2-migration-guide).
</Warning>

The Prelude API is a [REST](https://en.wikipedia.org/wiki/REST) API and uses standard
HTTP features and [statuses](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status).

The current URL is `https://api.ding.live/v1`.

## Authentication

To perform requests on the API, you need to provide two secrets:

* `API_KEY` - a key that identifies your application in the `X-API-Key` header.
* `CUSTOMER_UUID` - your app’s unique identifier in the `customer_uuid` request body field.

You can get them in the **Settings > API Keys** tab of the [Dashboard](https://app.prelude.so), under the
*Legacy Credentials* section.

```sh Example request theme={null}
curl --request POST \
     --url 'https://api.ding.live/v1/*' \
     --header 'Accept: application/json' \
     --header 'X-API-Key: <API_KEY>'
```

## Errors

The Prelude API returns errors using a JSON object in the response body with a
machine-readable `code` and a human-readable `message`.

See [Errors](/verify/v1/documentation/errors) for more details.

***

## SDKs

Prelude offers SDKs for the most popular languages:

<CardGroup cols={4}>
  <Card title="Node" icon="node-js" href="/verify/v1/sdks/typescript" />

  <Card title="Python" icon="python" href="/verify/v1/sdks/python" />

  <Card title="Go" icon="golang" href="/verify/v1/sdks/golang" />

  <Card title="Java" icon="java" href="/verify/v1/sdks/java" />

  <Card title="PHP" icon="php" href="/verify/v1/sdks/php" />

  <Card title="Ruby" icon="gem" href="/verify/v1/sdks/ruby" />

  <Card title="C#" icon="microsoft" href="/verify/v1/sdks/csharp" />
</CardGroup>

## Reference

Explore the Prelude API reference to learn more about the available endpoints:

<CardGroup cols={3}>
  <Card title="OTP" icon="lock" href="/verify/v1/api-reference/send-a-code">
    Send OTP codes to your users.
  </Card>

  <Card title="Errors" icon="circle-exclamation" href="/verify/v1/documentation/errors">
    Handle errors in your integration.
  </Card>
</CardGroup>