# Get merchant statements

Retrieve a list of available monthly statements for the authenticated merchant

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

## Path parameters:

  - `merchantId` (string, required)
    The unique identifier of the merchant
    Example: "merchant_2x4y6z8a0b1c2d3e4f5g6h7j8k"

## 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


## Response 400 fields

## Response 404 fields

## Response 500 fields