---
title: "Consulta de lote por ID"
method: GET
path: "/cards/batches/:{lotId}"
tags: ["Cartões No Name"]
---

# Consulta de lote por ID

`GET /cards/batches/:{lotId}`

## Request

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

<div class="bkly-ref-description">
  <p>Obtenha os dados de um lote específico de cartões.</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 [Consulta de lote por ID](/docs/consulta-de-lote-por-id)."
}
[/block]

## Path parameters

- `lotId` string, required: Id do lote a ser consultado.

## 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 com sucesso.

- CardLotResponse
  - `lotId` string: Identificador único do lote
  - `quantityOrder` integer: Quantidade de cartões solicitados.
  - `dateOrder` string, date-time: Data da solicitação de criação do lote.
  - `programId` integer: Identificador do programa vinculado ao cartão.
  - `cards` unknown[]: Proxy dos cartões.
    - unknown
  - `address` AddressResponse: Objeto que contém informações sobre o endereço do cliente.
    - `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.

## Other responses

- `400` (unresolved $ref)
- `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)