---
title: "Returns validation batches for a given customer"
method: GET
path: "/internal/customers/{customer_shinkansen_fin_id}/validation_batches"
tags: ["Internal"]
---

# Returns validation batches for a given customer

`GET /internal/customers/{customer_shinkansen_fin_id}/validation_batches`

## Request

- Base URL: `https://api.validator.shinkansen.finance/v1`
- URL: `https://api.validator.shinkansen.finance/v1/internal/customers/{customer_shinkansen_fin_id}/validation_batches`
- Auth: API key in header `Shinkansen-Validator-Api-Key`

Used internally by Shinkansen (e.g, for the Shinkansen Dashboard).

## Query parameters

- `page_size` integer
- `page` integer
- `status` 'pending' | 'performed'
- `id` string
- `before_datetime` string, date-time
- `after_datetime` string, date-time

## Response `200`

Returns a list of validation batches plus pagination metadata

- InternalBatchList: Internal validation batch list response
  - `meta` PaginationMeta, required: Metadata for responses with pagination support.
    - `current_page` integer, required: The current page number of the paginated response.
    - `previous_page` integer, nullable, required: The previous page number of the paginated response. `null` if there is no previous page.
    - `next_page` integer, nullable, required: The next page number of the paginated response. `null` if there is no next page.
    - `page_size` integer, required: The number of elements per page of the paginated response.
    - `total_count` integer, required: The total number of elements in the paginated response.
    - `total_pages` integer, required: The total number of pages in the paginated response.
  - `validation_batches` BatchWithoutRequests[], required: A list of validation batches.
    - `id` string, uuid, required: The id of the validation batch. Set by customer. Must be unique. It is used for idempotency: You can retry the same request with the same id and Shinkansen Validator will process it only once.
    - `source_type` 'file' | 'other', required: The type of the source of the validation batch. Set by customer. Can be: * `file` if the validation batch was created via a CSV/Excel upload * `other` if the validation batch was created from any other source
    - `source_name` string, required: The name of the source of the validation batch. If `source_type` is `file` then this is the name of the file that was uploaded. Set by customer.
    - `inserted_at` string, date-time, required: The timestamp when the validation batch was created. Set by Shinkansen Validator.
    - `updated_at` string, date-time, required: The timestamp when the validation batch was last updated. Set by Shinkansen Validator.
    - `status` 'pending' | 'performed', required: The status of the batch as a whole. It can be: * `pending` if at least one of the validations in the batch is pending (or is being retried due to errors) * `performed` if all of the validations have been completed (even if some of them failed after retrying a few times)

## Other responses

- `403`: Forbidden (e.g: wrong API Key)
- `404`: Customer fin id not found.

---

[API](https://skmtc.dev/shinkansen/apis/validator-shinkansen-endpoints.md) - [All operations](https://skmtc.dev/shinkansen/apis/validator-shinkansen-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/shinkansen/apis/validator-shinkansen-endpoints/revisions/4502fbbb6325?raw)