---
title: "Get voided checks"
method: GET
path: "/api/demographics/v1/Documents/{merchantNumber}/VoidedChecks"
tags: ["Documents"]
---

# Get voided checks

`GET /api/demographics/v1/Documents/{merchantNumber}/VoidedChecks`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/xplorpay/apis/external-us-onboarding-workflow/docs/api/demographics/v1/Documents/:merchantNumber/VoidedChecks/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint uses the eDoc service to retrieve details of all documents in the voided check category for a specified merchant number. The response
provides information such as the Document ID, file name, description, and category details.

## Path parameters

- `merchantNumber` string, required

## Response `200`

Returns a collection of voided checks successfully.

- MerchantDemographicsApiModelsEDocsFileCollection
  - `content` MerchantDemographicsApiModelsEDocsFile[], nullable: Contains the details of the document.
    - `category` integer, required: The category of the document, represented as an integer value.
    - `categoryDescription` string, nullable: A description of the document category.
    - `description` string, nullable: A brief description of the document.
    - `documentId` string, uuid: The unique identifier for the document.
    - `fileName` string, required: The name of the file associated with the document.
    - `merchantNumber` string, required: The merchant's unique identifier.
    - `metaData` MerchantDemographicsApiModelsEDocsFileMetaData[], nullable: A list of metadata associated with the document.
      - `metadataKey` string, nullable: The key or name of the metadata field.
      - `metadataValue` string, nullable: The value associated with the metadata key.
    - `fileExtension` string, nullable: The file extension of the document.
    - `dateUploaded` string, nullable: The date and time (ISO 8601 format) when the document was uploaded. Format: yyyy-MM-ddTHH:mm:ssZ

## Other responses

- `204`: No Content
- `400`: Bad Request: Returns when merchantNumber is null or empty.
- `401`: Unauthorized: User does not have the required role or access.
- `403`: Forbidden: The user does not have the necessary permissions to access this resource.
- `500`: Internal Server Error: This could be due to system errors. Please contact support for assistance

---

[API](https://skmtc.dev/xplorpay/apis/external-us-onboarding-workflow.md) - [All operations](https://skmtc.dev/xplorpay/apis/external-us-onboarding-workflow/llms.txt) - [OpenAPI document](https://skmtc.dev/xplorpay/apis/external-us-onboarding-workflow/revisions/f37077c24b66?raw)