---
title: "Obtém uma assinatura de monitoramento pelo external_id"
method: GET
path: "/partner-monitoring/subscriptions/{external_id}"
tags: ["Monitoramento"]
---

# Obtém uma assinatura de monitoramento pelo external_id

`GET /partner-monitoring/subscriptions/{external_id}`

## Path parameters

- `external_id` string, required — Identificador da assinatura

## Response `200`

Successful Response

- RestCompleteSubscriptionResponseDTO
  - `id` string, uuid, required — Identificador da assinatura
  - `contact` RestContactDTO, required
    - `name` string, nullable — Nome do contato
    - `email` string, nullable — Email do contato
    - `phone` string, nullable — Telefone do contato
  - `external_id` string, nullable — Identificador externo
  - `created_at` string, date-time, required — Data de criação
  - `next_search_at` string, date, nullable — Data da próxima busca
  - `plan_id` string, uuid, required — Identificador do plano
  - `is_active` boolean, required — Indica se a assinatura está ativa
  - `is_canceled` boolean, required — Indica se a assinatura foi cancelada
  - `vehicles` RestVehicleResponseDTO[] — Veículos monitorados
    - `id` string, uuid, required — Identificador do veiculo
    - `contract_id` string, uuid, required — Identificador do contrato vinculado
    - `license_plate` string, required — Placa do veiculo
    - `state` 'AC' | 'AL' | 'AP' | 'AM' | 'BA' | 'CE' | 'DF' | 'ES' | 'GO' | 'MA' | 'MT' | 'MS' | 'MG' | 'PA' | 'PB' | 'PR' | 'PE' | 'PI' | 'RJ' | 'RN' | 'RS' | 'RO' | 'RR' | 'SC' | 'SP' | 'SE' | 'TO'
    - `owner_document` string, nullable — Documento do proprietário
    - `renavam` string, nullable — Renavam do veiculo
    - `chassis` string, nullable — Chassi do veiculo
    - `is_active` boolean, nullable — Indica se o contrato está ativo
  - `drivers` RestDriverResponseDTO[] — Condutores monitorados
    - `name` string, required — Nome do condutor
    - `document` string, required — Documento do condutor
    - `actual_points` integer, nullable — Pontos atuais
  - `vehicle_histories` RestVehicleHistoryDTO[] — Historico de veiculos
    - `license_plate` string, required — Placa do veiculo

## Other responses

- `400` — Erro na requisição
- `401` — Não autorizado
- `404` — Assinatura não encontrada
- `422` — Validation Error

---

[API](https://skmtc.net/usezapay/apis/zapi.md) · [All operations](https://skmtc.net/usezapay/apis/zapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usezapay/zapi/versions/50c96157fff4/schema)