---
title: "Consulta a assinatura por id"
method: GET
path: "/api/Assinatura/{Id}"
tags: ["Assinatura"]
---

# Consulta a assinatura por id

`GET /api/Assinatura/{Id}`

Esta API permite realizar consultas  por ID.

### Requisão
| **Campo** | **Tipo** | **Descrição** | **Obrigatório** |
|--|--|--|--|
| Id | GUID | Identificador da assinatura | Sim |

### Resposta 
| **Campo** | **Tipo** | **Descrição** | 
|--|--|--| 
| Criacao |Data  | Data em que a cobrança foi criada | 
| Id | GUID | Identificador único da assinatura | 
| ClienteId | GUID | Identificador único do cliente | 
| ClienteNome | Texto | Nome do cliente que será realizada a cobrança | 
| Descricao | Texto | Breve descrição sobre a cobrança | 
| Valor | Númerico | Valor da cobrança | 
| Periodicidade | Texto | Período o qual a cobrança será enviada ao cliente| 
| DiasGeracaoCobranca | Numérico  | Dias para gerar a cobrança de assinatura | 
| IniciandoEm | Data | Data de início da assinatura | 
| FinalizandoEm | Data | Data de fim da assinatura | 
| FormasPagamento | Texto | Forma de pagamento da cobrança | 
| ProdutoId | GUID  |Identificador único do produto caso houver  | 
| Multa | Numérico  | Valor da multa caso haja algum tipo de atraso | 
| JurosMes | Numérico | Porcentagem de juros ao mes após o vencimento | 
| DescontoAteVencimento | Numérico  | Desconto até a última data do vencimento da assinatura | 
| SplitValores | Array | Array especificando o “split” financeiro dos valores arrecadados pelo pagamento para diversas contas do meuK8, a partir do código de cliente e do valor respectivo | 
| ClientePagamentosId | GUID | Id do cliente de pagamento | 
| Valor | Número | Valor da assinatura |

## Path parameters

- `Id` string, required

## Headers

- `Aeskey` string, required

## Response `200`

>Assinatura consultada

- BknBankCobrancasAPIModelsAssinaturaResponse
  - `Criacao` string, date-time — Data de criação da assinatura
  - `Id` string — Id da assinatura
  - `ClienteId` string, uuid — Id do cliente relacionado a assinatura
  - `ClienteNome` string — Nome do cliente relacionado a assinatura, somente para retornar dados
  - `Descricao` string, required — Descrição da assinatura
  - `Valor` number, double — Valor da assinatura
  - `Periodicidade` 'Todos' | 'Mensal' | 'Semanal' | 'Quinzenal' | 'Bimestral' | 'Trimestral' | 'Semestral' | 'Anual' — Periodicidade da assinatura
  - `DiasGeracaoCobranca` integer — Dias para gerar a cobrança de assinatura
  - `IniciandoEm` string, date-time — Data de início da assinatura
  - `FinalizandoEm` string, date-time — Data de fim da assinatura
  - `FormasPagamento` 'Nenhum' | 'Boleto' | 'Cartao' | 'Pix' | 'Manual' | 'Protesto' | 'SaldoWebConta' — Formas de pagamento da assinatura
  - `ProdutoId` string, uuid — Id do produto da assinatura
  - `Multa` number, double — Multa percentual da assinatura
  - `JurosMes` number, double — Juros percentual ao mês da assinatura
  - `DescontoAteVencimento` number, double — Desconto percentual para pagamento até o vencimento da assinatura
  - `SplitValores` BknBankCobrancasAPIModelsSplitAssinaturaRequest[] — Definicao de split para a assinatura
    - `ClientePagamentosId` string, uuid — Id da produto associado ao split
    - `Valor` number, double — Valor nominal de credito para o participante
  - `AutoEmiteFormaPagamento` boolean

## Other responses

- `401` — Não há permissão para acessar esta assinatura
- `404` — Não existe a assinatura por Id
- `500` — Id inválido da assinatura ou erro carregando assinatura

---

[API](https://skmtc.net/meuk8/apis/k8-fintech.md) · [All operations](https://skmtc.net/meuk8/apis/k8-fintech/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meuk8/k8-fintech/revisions/14db4977f490/schema)