Buscar Assinatura

Recuperar assinatura

get

https://api.barte.comhttps://sandbox-api.barte.com

/v2/subscriptions/{uuid}

Retorna os dados de uma assinatura específica

Authorizations

ApiKeyAuth

X-Token-ApistringRequired

Token de autenticação para acesso à API

Path parameters

uuidstring · uuidRequired

UUID da assinatura

Header parameters

X-Token-ApistringRequired

Token de autenticação para acesso à API

Content-Typestring · enumOptional

Tipo de conteúdo da requisição

Possible values:

x-idempotency-keystringOptional

Chave de idempotência

x-ip-origin-requeststringOptional

IP de origem da requisição

Responses

200

Dados da assinatura retornados com sucesso

application/json

400

Erro de validação

application/json

401

Token inativo ou inexistente

application/json

403

Acesso negado

application/json

404

Assinatura não encontrada

application/json

429

Muitas requisições

application/json

500

Erro interno do servidor

application/json

get

/v2/subscriptions/{uuid}

HTTPcURLJavaScriptPython

GET /v2/subscriptions/{uuid} HTTP/1.1
Host: api.barte.com
X-Token-Api: text
Accept: */*

{
  "uuid": "text",
  "status": "PENDING",
  "customer": {
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "email": "[email protected]",
    "document": "text"
  },
  "startDate": "2026-01-05",
  "value": {
    "type": "MONTHLY",
    "valuePerMonth": 1
  },
  "additionalValue": {
    "installments": 1,
    "value": 1
  },
  "paymentMethod": "CREDIT_CARD",
  "charges": [
    {
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "status": "ABANDONED",
      "value": 1,
      "createdAt": "2026-01-05T10:22:15.596Z",
      "updatedAt": "2026-01-05T10:22:15.596Z"
    }
  ]
}