> ## Documentation Index > Fetch the complete documentation index at: https://safepay.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List Settlement Report Exports > List settlement report export for aggregator. ## OpenAPI ````yaml /api-reference/openapi.yaml get /v1/aggregators/{raast-aggregator-id}/settlements/report-exports openapi: 3.1.0 info: title: Raast Wire version: 1.0.0 description: '' servers: - url: https://api.getsafepay.com/raastwire security: [] tags: - name: Aggregators - name: Access Keys - name: Merchants - name: Raast Merchants - name: Payments - name: Refunds - name: QRs - name: Utilities - name: Aliases - name: Ledgers - name: Webhooks paths: /v1/aggregators/{raast-aggregator-id}/settlements/report-exports: get: tags: - Settlement Reports summary: List Settlement Report Exports description: List settlement report export for aggregator. parameters: - name: aggregator_id in: path required: true description: Aggregator identifier that owns the settlement report exports. schema: type: string example: agg_b49985f2-e099-412e-8eb2-98756059cc0d - name: settlement_batch_id in: query required: false description: Filter report exports by settlement batch identifier. schema: type: string example: sb_6eb80843-eb2b-4df2-b85f-25d50f03d2a1 - name: merchant_id in: query required: false description: Filter report exports by merchant identifier. schema: type: string example: mer_0e4b3a32-754b-483a-9c85-80581dbef4cf - name: kind in: query required: false description: >- Filter report exports by report kind (1=REPORT_KIND_SEED, 2=REPORT_KIND_BATCH, 3=REPORT_KIND_MERCHANT). schema: type: string enum: - 1 - 2 - 3 example: 2 - name: status in: query required: false description: >- Filter report exports by processing status (1=PENDING, 2=RUNNING, 3=SUCCEEDED, 4=FAILED, 5=SEEDED, 6=RETRYING). schema: type: integer format: int32 enum: - 1 - 2 - 3 - 4 - 5 - 6 example: 3 - name: started_at_from in: query required: false description: Include report exports started at or after this Unix timestamp. schema: type: integer format: int64 example: 1711929600 - name: started_at_to in: query required: false description: Include report exports started at or before this Unix timestamp. schema: type: integer format: int64 example: 1712016000 - name: date_from in: query required: false description: Include report exports created on or after this Unix timestamp. schema: type: integer format: int64 example: 1711929600 - name: date_to in: query required: false description: Include report exports created on or before this Unix timestamp. schema: type: integer format: int64 example: 1712016000 - name: limit in: query required: false description: Maximum number of records to return. schema: type: string example: '20' - name: offset in: query required: false description: Number of records to skip before listing results. schema: type: string example: '0' responses: '200': $ref: '#/components/responses/ListSettlementReportExportsResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' security: - apiKey: [] components: responses: ListSettlementReportExportsResponse: description: Paginated list of settlement report export jobs. headers: Content-Length: $ref: '#/components/headers/ContentLengthHeader' Date: $ref: '#/components/headers/DateHeader' content: application/json: schema: allOf: - $ref: '#/components/schemas/StandardResponse' - type: object properties: data: type: object properties: report_exports: type: array items: $ref: '#/components/schemas/SettlementReportExport' count: type: string example: '4' examples: SettlementReportExportsListed: value: api_version: v1 data: report_exports: - id: '56' token: rpt_528221c6-d6ff-421f-a67e-73bae7451743 settlement_batch_id: sb_6eb80843-eb2b-4df2-b85f-25d50f03d2a1 merchant_id: '' kind: REPORT_KIND_BATCH status: REPORT_STATUS_SUCCEEDED attempts: 1 error_message: '' s3_key: >- reports/partner_37e414c3-c0cc-4541-9bea-ab5a22964bd8/sb_6eb80843-eb2b-4df2-b85f-25d50f03d2a1/batch/batch-settlement-report-1775215813-v1.csv record_count: '5' file_size: '2508' started_at: '2026-04-03T11:30:14Z' finished_at: '2026-04-03T11:30:14Z' created_at: '2026-04-03T11:30:09Z' updated_at: '2026-04-03T11:30:14Z' partner_id: partner_37e414c3-c0cc-4541-9bea-ab5a22964bd8 version: 1 - id: '58' token: rpt_7670f587-0396-4939-ba4b-585ca67983a2 settlement_batch_id: sb_6eb80843-eb2b-4df2-b85f-25d50f03d2a1 merchant_id: mer_0e4b3a32-754b-483a-9c85-80581dbef4cf kind: REPORT_KIND_MERCHANT status: REPORT_STATUS_SUCCEEDED attempts: 1 error_message: '' s3_key: >- reports/partner_37e414c3-c0cc-4541-9bea-ab5a22964bd8/sb_6eb80843-eb2b-4df2-b85f-25d50f03d2a1/mer_0e4b3a32-754b-483a-9c85-80581dbef4cf/merchant-settlement-report-1775215823-v1.csv record_count: '2' file_size: '1234' started_at: '2026-04-03T11:30:24Z' finished_at: '2026-04-03T11:30:24Z' created_at: '2026-04-03T11:30:09Z' updated_at: '2026-04-03T11:30:24Z' partner_id: partner_37e414c3-c0cc-4541-9bea-ab5a22964bd8 version: 1 - id: '57' token: rpt_48cc48c6-2088-4fa7-a790-007a1c4e2ac3 settlement_batch_id: sb_6eb80843-eb2b-4df2-b85f-25d50f03d2a1 merchant_id: mer_ce6df98c-cdde-48bf-bc32-464cecac2ee3 kind: REPORT_KIND_MERCHANT status: REPORT_STATUS_SUCCEEDED attempts: 1 error_message: '' s3_key: >- reports/partner_37e414c3-c0cc-4541-9bea-ab5a22964bd8/sb_6eb80843-eb2b-4df2-b85f-25d50f03d2a1/mer_ce6df98c-cdde-48bf-bc32-464cecac2ee3/merchant-settlement-report-1775215818-v1.csv record_count: '3' file_size: '1666' started_at: '2026-04-03T11:30:19Z' finished_at: '2026-04-03T11:30:19Z' created_at: '2026-04-03T11:30:09Z' updated_at: '2026-04-03T11:30:19Z' partner_id: partner_37e414c3-c0cc-4541-9bea-ab5a22964bd8 version: 1 - id: '55' token: rpt_e71265de-6699-4a02-b99b-b985edb9b915 settlement_batch_id: sb_6eb80843-eb2b-4df2-b85f-25d50f03d2a1 merchant_id: '' kind: REPORT_KIND_SEED status: REPORT_STATUS_SEEDED attempts: 1 error_message: '' s3_key: '' record_count: '0' file_size: '0' started_at: '2026-04-03T11:30:09Z' finished_at: null created_at: '2026-04-03T11:30:04Z' updated_at: '2026-04-03T11:30:09Z' partner_id: partner_37e414c3-c0cc-4541-9bea-ab5a22964bd8 version: 0 count: '4' BadRequest: description: Bad request headers: Content-Length: $ref: '#/components/headers/ContentLengthHeader' Date: $ref: '#/components/headers/DateHeader' content: application/json: schema: allOf: - $ref: '#/components/schemas/ErrorResponse' - type: object properties: code: example: error.bad_request message: example: Invalid request parameters Unauthorized: description: Unauthorized headers: Content-Length: $ref: '#/components/headers/ContentLengthHeader' Date: $ref: '#/components/headers/DateHeader' content: application/json: schema: $ref: '#/components/schemas/ApiErrorEnvelope' examples: Unauthorized: value: api_version: v1 error: code: error.unauthorized_access message: partner access key is required in request header headers: ContentLengthHeader: schema: type: string example: '256' DateHeader: schema: type: string example: Sat, 12 Aug 2023 08:55:04 GMT schemas: StandardResponse: type: object description: Standard response structure for successful operations properties: api_version: type: string example: v1 description: The current version of the API spec data: type: object description: Contains the response data SettlementReportExport: type: object description: Settlement report export job metadata and processing status. properties: id: type: string example: '58' token: type: string example: rpt_7670f587-0396-4939-ba4b-585ca67983a2 settlement_batch_id: type: string example: sb_6eb80843-eb2b-4df2-b85f-25d50f03d2a1 merchant_id: type: string example: mer_0e4b3a32-754b-483a-9c85-80581dbef4cf kind: type: string example: REPORT_KIND_MERCHANT status: type: string example: REPORT_STATUS_SUCCEEDED attempts: type: integer example: 1 error_message: type: string example: '' s3_key: type: string example: >- reports/partner_37e414c3-c0cc-4541-9bea-ab5a22964bd8/sb_6eb80843-eb2b-4df2-b85f-25d50f03d2a1/mer_0e4b3a32-754b-483a-9c85-80581dbef4cf/merchant-settlement-report-1775215823-v1.csv record_count: type: string example: '2' file_size: type: string example: '1234' started_at: allOf: - $ref: '#/components/schemas/Timestamp' nullable: true finished_at: allOf: - $ref: '#/components/schemas/Timestamp' nullable: true created_at: $ref: '#/components/schemas/Timestamp' updated_at: $ref: '#/components/schemas/Timestamp' partner_id: type: string example: partner_37e414c3-c0cc-4541-9bea-ab5a22964bd8 version: type: integer example: 1 ErrorResponse: type: object description: Standard error response structure properties: code: type: string description: Error code identifying the type of error message: type: string description: Human-readable error message ApiErrorEnvelope: type: object description: Error wrapper that includes the API version and error metadata properties: api_version: type: string description: Indicates the API version associated with the response example: v1 error: description: Structured error details describing why the request failed allOf: - $ref: '#/components/schemas/ErrorResponse' example: code: error.unauthorized_access message: partner access key is required in request header Timestamp: type: string format: date-time description: ISO 8601 timestamp in UTC example: '2025-03-13T09:12:34.000Z' securitySchemes: apiKey: type: apiKey name: X-SFPY-AGGREGATOR-SECRET-KEY in: header ````