---
title: "Antecipação de título bancário em lote (TB002)"
method: POST
path: "/v1/api/tb/anticipation"
tags: ["Títulos bancários"]
---

# Antecipação de título bancário em lote (TB002)

`POST /v1/api/tb/anticipation`

Registra antecipação (resgate antecipado ou recompra) sobre título emitido.
Encaminhado ao serviço `tio-external-api` (tio-csd-external-api), path canónico `/csd-assets/v1/tb/anticipation`.

## Request body

- AnticipationRequest[]
  - `externalReference` string, required — Unique event code generated by the participant's system, used for operation traceability.
  - `assetId` string, required — Identifier of the asset on which the anticipation will be performed.
  - `anticipationType` '1' | '2', required — Type of anticipation operation. - `1` = Redemption (early redemption by the investor) - `2` = Repurchase (buyback by the issuer)
  - `operationValues` OperationValuesRequired, required — Financial values related to the operation (all fields required).
    - `quantity` integer, required — Total quantity of securities registered for this asset.
    - `unitPrice` number, required — Unit price of the security in BRL, with up to 8 decimal places and a maximum of 15 integer digits.
    - `totalAmount` number, required — Total financial value in BRL, with up to 2 decimal places and a maximum of 15 integer digits.
  - `counterpartyDocument` string, nullable — CNPJ or CPF of the counterparty agent involved in the anticipation operation, digits only, no punctuation.
  - `settlementType` '1' | '2' | '3', required — Financial settlement type for the operation. - `1` = NoSettlement (no settlement) — `settlementAgentExternalRef` must be omitted - `2` = GrossSettlement (real-time gross settlement) - `3` = NetSettlement (deferred net settlement)
  - `settlementAgentExternalRef` string, nullable — External reference of the institution responsible for the financial settlement of the operation. - **Must be omitted** when `settlementType` = `1`
  - `ownerAgentDocument` string, nullable — CNPJ of the counterparty's agent (holder) of the securities involved in the anticipation, digits only, no punctuation.
  - `ownerDocument` string, nullable — CNPJ or CPF of the investor (end holder) of the securities subject to the anticipation, digits only, no punctuation.

## Response `207`

Multi-Status

- object[]
  - `externalReference` string, required — Unique reference code generated by the participant's system, echoed from the request.
  - `operationDate` string, date-time, required — Date and time of operation processing in `yyyy-MM-ddThh:mm:ss.sss` format.
  - `protocol` string, required — Internal tracking identifier generated by the CERC system, used for processing traceability.
  - `assetId` string, nullable — Asset identifier generated by CERC. Populated only when the operation results in the creation of a new asset.
  - `errors` object[], nullable — Failure list when `status` = `2`, or additional information about the operation.
    - `code` string, required — Application error code.
    - `message` string, required — Error description.
  - `status` '1' | '2', required — Operation processing status. - `1` = ACCEPTED - `2` = REJECTED

## Other responses

- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/cerc/apis/receb-veis-de-arranjo-de-pagamento-institui-es-financeiras-d.md) · [All operations](https://skmtc.net/cerc/apis/receb-veis-de-arranjo-de-pagamento-institui-es-financeiras-d/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cerc/receb-veis-de-arranjo-de-pagamento-institui-es-financeiras-d/revisions/98997c37ec38/schema)