---
title: "Realizar uma portabilidade out"
method: POST
path: "/portabilities"
tags: ["Portability"]
---

# Realizar uma portabilidade out

`POST /portabilities`

## Request

- Base URL: `https://api.sandbox.empresas.btgpactual.com`
- URL: `https://api.sandbox.empresas.btgpactual.com/portabilities`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://id.btgpactual.com/oauth2/token` scopes: `empresas.btgpactual.com/portabilities`

Criação de um pedido de portabilidade out

## Request body

- object
  - `contract_number` string, required: Identificador do contrato a ser portado
  - `registration_identification` string, required: Identificador único para a portabilidade
  - `proposer_ispb` string: ISPB do banco propoente da portabilidade
  - `proposer_tax_id` string: CNPJ do banco propoente da portabilidade
  - `portability_date` string, date, required: Data e hora da requisição

## Response `201`

Sucesso

- object
  - `portability_id` string: Identificador de excecução da portabilidade
  - `trade` object
    - `contract_number` string: Identificador do contrato a ser portado
    - `balance` string: Valor de posição do credito

## Other responses

- `400`: Erro
- `401`: Não autorizado
- `404`: Contrato não encontrado
- `500`: Erro

---

[API](https://skmtc.dev/btgpactual/apis/folha-de-pagamentos.md) - [All operations](https://skmtc.dev/btgpactual/apis/folha-de-pagamentos/llms.txt) - [OpenAPI document](https://skmtc.dev/btgpactual/apis/folha-de-pagamentos/revisions/2a24d3da114c?raw)
