---
title: "Por proxy"
method: GET
path: "/cards/{proxy}/tracking"
tags: ["Rastreio de cartões"]
---

# Por proxy

`GET /cards/{proxy}/tracking`

## Request

- Base URL: `https://api-mtls.sandbox.bankly.com.br`
- URL: `https://api-mtls.sandbox.bankly.com.br/cards/{proxy}/tracking`
- Auth: HTTP bearer

<div class="bkly-ref-description">
  <p>Obtenha o rastreio do cartão pelo seu <i>proxy</i>.</p> 
  <span class="bkly-ref-small-stable-tag">stable</span> 
  <span class="bkly-ref-scope-tag">scope: card.read</span>
</div>
[block:callout]
{
  "type": "info",
  "title": "Nota",
  "body": "Para mais informações, confira a documentação [Rastreio de cartões por <i>proxy</i>](/docs/rastreio-cartoes-por-proxy)."
}
[/block]

## Path parameters

- `proxy` string, required

## Headers

- `api-version` string, required: Versão da API. Atualmente estamos na versão 1.0.
- `Authorization` string, required: <em>Token</em> de autorização do tipo Bearer.

## Response `200`

Solicitação recebida. O retorno é o rastreio do cartão do proxy correspondente.

- TrackingResponse
  - `name` string: Nome impresso no cartão.
  - `alias` string: Apelido do cartão. Exemplo: cartão educação.
  - `externalTracking` object: Objeto para rastreio de serviço externo.
    - `code` string: Código de rastreio junto ao serviço externo.
    - `partner` string: Nome do parceiro do serviço externo.
  - `function` string: Função do cartão, que pode ser "Pré", "Pós", "Débito" ou "Combo".
  - `estimatedDeliveryDate` string, date-time: Data prevista da entrega do cartão.
  - `address` AddressResponse[]: Lista de objetos que contém informações sobre o endereço do titular do cartão no qual deve ser realizada a entrega.
    - `zipCode` string: Código postal de endereço.
    - `address` string: Logradouro (nome da rua, avenida etc.).
    - `number` string: Número do imóvel.
    - `complement` string: Complemento do endereço.
    - `neighborhood` string: Nome do bairro.
    - `city` string: Nome da cidade.
    - `state` string: Nome do estado. Formato ISO 3166-2:BR.
    - `country` string: Nome do país. Formato ISO 3166-2:BR.
  - `status` object[]: Lista com o histórico da situação do rastreio.
    - `createdDate` string, date-time: Data em que o <i>status</i> foi aplicado.
    - `statusDate` string, date-time: Data e hora em que o <i>status</i> passou a entrar em vigor na empresa de transporte.
    - `type` 'Created' | 'Building' | 'InProgress' | 'NotDelivered' | 'Cancelled' | 'Custody' | 'Delivered'
    - `reason` string: Informações sobre o <i>status</i>.
  - `finalized` object[]: Lista que contém o histórico de baixa do rastreio.
    - `createdDate` string, date-time: Data em que a baixa foi adicionada.
    - `finalizedDate` string, date-time: Data de entrega do cartão.
    - `recipientName` string: Nome do recebedor do cartão.
    - `recipientKinship` string: Grau de parentesco do recebedor com o proprietário do cartão.
    - `documentNumber` string: Número do documento do recebedor do cartão.
    - `attempts` number: Número de tentativas de entrega.

## Other responses

- `401` (unresolved $ref)
- `404` (unresolved $ref)
- `500` (unresolved $ref)

---

[API](https://skmtc.dev/bankly/apis/gest-o-de-cart-es.md) - [All operations](https://skmtc.dev/bankly/apis/gest-o-de-cart-es/llms.txt) - [OpenAPI document](https://skmtc.dev/bankly/apis/gest-o-de-cart-es/revisions/1116211d65a0?raw)