# API · Registration and renewal URL

> Registration or renewal URL of a recurring plan for a given email.

- kind: api-operation
- status: stable
- api_version: v1
- last_verified: 2026-08-29
- url: https://tilopay.com/en/developers/api/recurrentes/suscriptores/consult-url

```http
POST /api/v1/recurrentUrl
```

## What it does [#que-hace]

Returns the registration URL of a recurring plan for a new user, or the renewal URL when the email is already registered.

## Authentication [#autenticacion]

Requires the API bearer token in the `Authorization` header — see [authentication](/en/developers/api/autenticacion).

## Parameters [#parametros]

<Param id="consult-url-parametro-key" name="key" type="string" required>
Tilopay integration key.
</Param>

<Param id="consult-url-parametro-id" name="id" type="string" required>
Recurring plan id.
</Param>

<Param id="consult-url-parametro-email" name="email" type="string">
Email of the user the registration link is created for.
</Param>

## Request example [#request]

The `<...>` values are placeholders: replace them with your own credentials and data.

```json
{
  "key": "<api_key>",
  "id": "1",
  "email": "email@user.com"
}
```

## Response [#respuesta]

```json
{
  "type": "200",
  "message": "",
  "url_register": "https://app.tilopay.com/admin/recurrent/register/MjMy?email=email@user.com",
  "url_renew": ""
}
```

To interpret a response that is not a success, see [how to read an error response](/en/developers/api/procesos-operativos/errors).
