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

# Recuperar assinatura

`GET /v2/subscriptions/{uuid}`

## Request

- Base URL: `https://api.barte.com`
- URL: `https://api.barte.com/v2/subscriptions/{uuid}`
- Auth: API key in header `X-Token-Api`
- TypeScript: <https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/docs/v2/subscriptions/:uuid/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/barte/apis/api-de-sellers-v2-atualizada.md) - [All operations](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/llms.txt) - [OpenAPI document](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/revisions/f0dd55b167f1?raw)