Consulta de lotes

stablescopes: card.read

Este endpoint possibilita realizar a consulta de todos os lotes de cartões solicitados por uma determinada company key (chave que identifica o parceiro dentro do Bankly).

Etapas

Endpoint

curl --location --request GET 
--url 'https://api-mtls.sandbox.bankly.com.br/cards/batches' \  
--header 'api-version: 1' \  
--header 'Authorization: Bearer {{accessToken}}' \  
--header 'Content-Type: application/json' \

Retorno

O status code 200 indicará sucesso na consulta. O retorno trará uma lista de lotes com os seguintes campos:

  • lotId: valor identificador do lote;
  • quantityOrder: quantidade de cartões solicitados;
  • dateOrder: data da solicitação de criação do lote;
  • programId: identificador do programa vinculado ao cartão.
[ 
   { 
      "lotId": "LT2", 
      "quantityOrder": 100, 
      "dateOrder": "2022-04-01T14:46:02.6980536Z", 
      "programId": 489 
   }, 
   { 
      "lotId": "LT3", 
      "quantityOrder": 100, 
      "dateOrder": "2022-04-01T19:04:27.6244532Z", 
      "programId": 489 
   }, 
   { 
      "lotId": "LT4", 
      "quantityOrder": 100, 
      "dateOrder": "2022-04-06T16:01:40.4673261Z", 
      "programId": 489 
   }, 
   { 
      "lotId": "LT5", 
      "quantityOrder": 100, 
      "dateOrder": "2022-04-13T12:03:47.7765565Z", 
      "programId": 489 
   }, 
   { 
      "lotId": "LT6", 
      "quantityOrder": 100, 
      "dateOrder": "2022-04-13T12:12:37.4893008Z", 
      "programId": 489 
   }, 
   { 
      "lotId": "LT7", 
      "quantityOrder": 50, 
      "dateOrder": "2022-04-14T12:15:47.3895717Z", 
      "programId": 489 
   }, 
   { 
      "lotId": "LT8", 
      "quantityOrder": 50, 
      "dateOrder": "2022-04-14T18:12:34.6174675Z", 
      "programId": 489 
   }, 
   { 
      "lotId": "LT9", 
      "quantityOrder": 50, 
      "dateOrder": "2022-04-18T12:28:37.2938704Z", 
      "programId": 489 
   }, 
   { 
      "lotId": "LT10", 
      "quantityOrder": 50, 
      "dateOrder": "2022-04-18T13:41:49.1995198Z", 
      "programId": 489 
   }
 ]

Erros

Status codeCódigoDescrição
400INVALID_PARAMETERConteúdo da requisição não está de acordo com o esperado. Exemplos: tamanho de campo, tipo ou conteúdo obrigatório.
401UNAUTHORIZEDSem autorização para realizar a solicitação.
404116Não foram encontrados lotes para essa company key.
500014Ocorrência de erro inesperado.