---
title: "Recuperar assinatura"
method: GET
path: "/v2/subscriptions/{uuid}"
tags: ["Assinaturas"]
---

# Recuperar assinatura

`GET /v2/subscriptions/{uuid}`

Retorna os dados de uma assinatura específica

## Path parameters

- `uuid` string, uuid, required

## Headers

- `X-Token-Api` string, required
- `Content-Type` 'application/json'
- `x-idempotency-key` string
- `x-ip-origin-request` string

## Response `200`

Dados da assinatura retornados com sucesso

- SubscriptionResponse
  - `uuid` string
  - `status` 'PENDING' | 'ACTIVE' | 'DEFAULTER' | 'INACTIVE'
  - `customer` CustomerResponse
    - `document` string — Documento do cliente
    - `type` string — Tipo do documento
    - `documentCountry` string — País do documento
    - `name` string — Nome do cliente
    - `email` string, email — Email do cliente
    - `phone` string — Telefone do cliente
    - `alternativeEmail` string, email — Email alternativo
    - `integrationCustomerId` string, uuid — ID de integração do cliente
  - `startDate` string, date
  - `value` BasicValueResponse
    - `type` 'MONTHLY' | 'SEMESTER' | 'YEARLY'
    - `valuePerMonth` number, double
  - `additionalValue` AdditionalValueResponse
    - `installments` integer
    - `value` number, double
  - `paymentMethod` 'CREDIT_CARD' | 'PIX' | 'BANK_SLIP'
  - `charges` ChargeResponse[]
    - `uuid` string, uuid — UUID da cobrança
    - `title` string — Título da cobrança
    - `expirationDate` string, date — Data de expiração
    - `value` number — Valor da cobrança
    - `paymentMethod` string — Método de pagamento
    - `status` 'SCHEDULED' | 'APPROVED' | 'DECLINED' | 'PENDING' — Status da cobrança
    - `customer` object
      - `document` string
      - `type` string
      - `name` string
      - `email` string, email
      - `phone` string
      - `alternativeEmail` string, email

## Other responses

- `400` — Erro de validação
- `401` — Token inativo ou inexistente
- `403` — Acesso negado
- `404` — Assinatura não encontrada
- `429` — Muitas requisições
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/barte/apis/api-de-sellers-v2-atualizada.md) · [All operations](https://skmtc.net/barte/apis/api-de-sellers-v2-atualizada/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/barte/api-de-sellers-v2-atualizada/versions/f0dd55b167f1/schema)