Get a financial export's status

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://docs.usehearsay.com/mcp

Standard setup for AI tools providing an mcp.json file

{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}

GET /financial-data/export/{jobId}

Access token

Returns the status of one financial export job (statement bundles included). When completed it also returns the file name, completion time and a fresh download URL; when failed, the error message. Only the user who started the export can see it; anyone else gets 404.

Path parameters

jobId string Required

Responses

200 application/json
Hide response attributes Show response attributes object
- data object Required
  
  Hide data attributes Show data attributes object
  
  jobId string Required
  
  Export job ID
  
  status string Required
  
  Values are pending, in-progress, completed, failed, or cancelled.
  
  downloadUrl string
  
  Pre-signed S3 download URL
  
  fileName string | null
  
  Generated file name
  
  completedAt string(date-time) | null
  
  errorMessage string | null
- statusCode number Required
- timestamp string(date-time) Required

GET /financial-data/export/{jobId}

curl \
 --request GET 'http://api.example.com/financial-data/export/{jobId}' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "data": {
    "jobId": "65a1b2c3d4e5f6a7b8c9d0e9",
    "status": "pending",
    "downloadUrl": "https://files.example.com/exports/transactions-2026-01-15.csv?signature=abc123",
    "fileName": "transactions-2026-01-15.csv",
    "completedAt": "2026-01-15T14:31:10.000Z",
    "errorMessage": "string"
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}