# Get merchant statements

Retrieve a list of available monthly statements for the authenticated merchant

Endpoint: GET /v1/statements/{merchantId}
Version: v1
Security: bearer, api-key-secret

## Security:

  - `bearer` (unknown)

  - `api-key-secret` (unknown)
    http basic

## Path parameters:

  - `merchantId` (string, required)
    The unique identifier of the merchant

## Response 200:

  - `200` (unknown)
    List of statements for the merchant

## Response 200 fields (application/json):

  - `statements` (array, required)
    List of available statements for the merchant

  - `statements.statement_id` (string, required)
    Unique identifier for the statement
    Example: stmt_2024_01_abc123

  - `statements.merchant_id` (string, required)
    Merchant identifier
    Example: merchant_2x4y6z8a0b1c2d3e4f5g6h7j8k

  - `statements.statement_date` (string, required)
    Statement date in YYYY-MM-DD format
    Example: 2024-01-31

  - `statements.period_start` (string, required)
    Period start date in YYYY-MM-DD format
    Example: 2024-01-01

  - `statements.period_end` (string, required)
    Period end date in YYYY-MM-DD format
    Example: 2024-01-31

  - `statements.total_amount` (number, required)
    Total amount for the statement period
    Example: 1250.75

  - `statements.currency` (string, required)
    Currency code
    Example: USD

  - `statements.status` (string, required)
    Statement status
    Enum: "available", "processing", "error"

  - `statements.download_url` (string)
    Download URL for the statement
    Example: https://api.taluspay.com/v1/statements/download/stmt_2024_01_abc123

  - `total_count` (number, required)
    Total number of statements available
    Example: 5

  - `merchant_id` (string, required)
    Merchant identifier
    Example: merchant_2x4y6z8a0b1c2d3e4f5g6h7j8k

## Response 400:

  - `400` (unknown)
    Merchant not approved - no MID available

## Response 404:

  - `404` (unknown)
    Merchant not found or no statements available

## Response 500:

  - `500` (unknown)
    Internal server error while fetching statements