---
title: "Parse recipient from clipboard"
method: POST
path: "/v1/banking/bank_recipients/parse"
tags: ["Bank recipient"]
---

# Parse recipient from clipboard

`POST /v1/banking/bank_recipients/parse`

Extracts structured bank-recipient fields from a free-text blob (e.g. the
typical "datos de transferencia" a payee pastes from WhatsApp or email) using
an AI parser. Returns the best-effort recipient fields; any field the parser
could not confidently extract is returned as `null`. The result is a
suggestion to prefill a recipient form — it does not create a recipient.

This endpoint does not require a company scope. It is rate-limited to 30
requests per minute per credential.

## Request body

- object
  - `text` string, required — The raw pasted text to parse into recipient fields.

## Response `200`

Best-effort parsed recipient fields (unresolved fields are null).

- object
  - `name` string, nullable
  - `alias` string, nullable
  - `rut` string, nullable — Normalized RUT without dots or hyphens.
  - `bank_id` string, nullable
  - `account_number` string, nullable
  - `account_type` 'corriente' | 'vista' | 'ahorro', nullable
  - `email` string, nullable

## Other responses

- `401` — Unauthorized
- `422` — The provided text was empty.
- `429` — Rate limit exceeded (more than 30 requests per minute).
- `502` — The AI parsing provider was unavailable.

---

[API](https://skmtc.dev/cardda/apis/banking-api.md) · [All operations](https://skmtc.dev/cardda/apis/banking-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cardda/banking-api/revisions/ff1aeb3fda8b/schema)