---
title: "Listar Importações"
method: GET
path: "/v1/imports/{collection_name}"
tags: ["Importações"]
---

# Listar Importações

`GET /v1/imports/{collection_name}`

## Request

- Base URL: `https://api-sandbox.kobana.com.br`
- URL: `https://api-sandbox.kobana.com.br/v1/imports/{collection_name}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/kobana/apis/cobran-as/docs/v1/imports/:collection_name/get.ts> (a function with typed inputs; its response is checked against the schema)

Lista as importações realizadas para um tipo específico de recurso (clientes, assinaturas, boletos ou carnês).

## Path parameters

- `collection_name` 'customers' | 'customer_subscriptions' | 'bank_billets' | 'installments', required

## Query parameters

- `page` integer
- `per_page` integer

## Headers

- `User-Agent` string

## Response `200`

Importações encontradas

- Import[]
  - `id` integer: ID da Importação.
  - `status` string: Status da importação. `enqueued`: Aguardando processamento. [Estado inicial] `failed`: Processamento não realizado devido a erro. `processed`: Processamento concluído.
  - `started_at` string, date-time, nullable: Data/hora de início do processamento da Importação
  - `finished_at` string, date-time, nullable: Data/hora de fim do processamento da Importação
  - `created_at` string, date-time: Data/hora da criação da Importação
  - `updated_at` string, date-time: Data/hora da atualização da Importação
  - `created_rows` integer
  - `enqueued_at` string, date-time, nullable
  - `processed_at` string, date-time, nullable
  - `failed_to_create_rows` integer
  - `failed_to_update_rows` integer
  - `import_errors` object, nullable
  - `processed_rows` integer
  - `total_rows` integer, nullable
  - `updated_rows` integer

---

[API](https://skmtc.dev/kobana/apis/cobran-as.md) - [All operations](https://skmtc.dev/kobana/apis/cobran-as/llms.txt) - [OpenAPI document](https://skmtc.dev/kobana/apis/cobran-as/revisions/728c362ec4d7?raw)