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

# Hosted Bank Link: Send a Link, No Code in Your Page

> Create a link on your server and send the person to its URL. Didit hosts every screen and can return them to your `redirect_url` when they finish.

Didit's hosted Bank Link is the way to connect a bank today: you create a link, send the person to its `url`, and Didit shows every screen on its own page.
Bank data is available for sandbox applications; a live application's calls answer `404` until live access is announced.

## Create the link and send the person

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/links/ \
  -H "x-api-key: $DIDIT_API_KEY" -H "content-type: application/json" \
  -d '{
    "access": "ongoing",
    "country": "ESP",
    "data": ["accounts", "balances", "transactions"],
    "end_user": { "reference": "client-7731" },
    "vendor_data": "client-7731"
  }'
```

Redirect the browser to the `url` in the response, or put it in an email or a message.
The `url` is returned only when the link is created, and it stops working when the link expires (60 minutes by default, 5 minutes to 24 hours with `expires_in`).

## What happens at the end

* With a `redirect_url` that Didit accepts, the browser returns to it. See [Return to your site](https://docs.didit.me/integration/bank-link/return-to-your-site.md).
* Without one, the flow ends on Didit's result page.
* Either way, the `bank.link.completed` webhook and `GET /v3/bank/links/{id}/` tell you the result.

## Confirm on your server

When `bank.link.completed` arrives, call `GET /v3/bank/links/{id}/` with the link id you stored for that user.
It returns `status: completed` with the `connection_id`, or a final failure with an `error.code`.
Then continue with the [quickstart](https://docs.didit.me/core-technology/bank-verification/quickstart.md#step-4-receive-the-webhooks-and-confirm).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.