> ## Documentation Index > Fetch the complete documentation index at: https://docs.ach.netevia.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Transaction List ( SUNSETTING ) > Get a list of transactions. **This Endpoint is Sunsetting and you should use the stable endpoint. Sunsetting APIs that are still supported but scheduled for deprecation.** ## OpenAPI ````yaml https://api.grailpay.com/docs?api-docs.json get /3p/api/v1/transaction/list openapi: 3.0.0 info: title: GrailPay ACH API description: API Documentation for moving funds via ACH using the GrailPay ACH API version: 2025.12.19.2 servers: - url: https://api.grailpay.com description: Production environment - url: https://api-sandbox.grailpay.com description: Sandbox environment security: [] tags: - name: Users description: >- API Endpoints used for the onboarding and managing People, Businesses, and Merchants. - name: Transactions description: API Endpoints used for creating and managing transactions. - name: Payouts description: API Endpoints used for fetching payout information. - name: Refunds description: API Endpoints used for creating and retrieving refunds. - name: Bank Accounts description: API Endpoints used for adding and managing bank accounts. - name: Webhooks description: API Endpoints used for registering and de-registering webhooks. - name: Billing description: API Endpoints used for retrieving billing information. - name: Stable description: Stable, up-to-date APIs that are recommended for current integration. - name: Sunsetting description: Sunsetting APIs that are still supported but scheduled for deprecation. - name: Deprecated description: Deprecated APIs that are no longer supported and should be removed. - name: SUNSETTING description: SUNSETTING paths: /3p/api/v1/transaction/list: get: tags: - Transactions - Sunsetting summary: Get Transaction List ( SUNSETTING ) description: >- Get a list of transactions. **This Endpoint is Sunsetting and you should use the stable endpoint. Sunsetting APIs that are still supported but scheduled for deprecation.** operationId: ca79263d4cbdc0814fc25b20757d9934 parameters: - name: startDate in: query description: Filter transactions created after this date (YYYY-MM-DD) schema: type: string format: date - name: endDate in: query description: Filter transactions created before this date (YYYY-MM-DD) schema: type: string format: date - name: page in: query description: Page number for pagination schema: type: integer - name: pageSize in: query description: Number of transactions per page schema: type: integer enum: - '10' - '20' - '50' - '100' - '200' responses: '200': description: Successful response content: application/json: schema: properties: status: type: boolean example: false message: type: string example: '' data: properties: transactions: type: array items: $ref: '#/components/schemas/V1TransactionResponse' pagination: properties: totalItems: type: integer example: 53 pageSize: type: integer example: 10 currentPage: type: integer example: 6 totalPages: type: integer example: 6 type: object type: object errors: type: string example: null error_code: type: string example: null type: object '401': description: Unauthorized content: application/json: schema: oneOf: - $ref: '#/components/schemas/Error401Unauthorized' - $ref: '#/components/schemas/Error401InvalidTokenStructure' - $ref: '#/components/schemas/Error401InvalidTokenData' '403': description: Forbidden content: application/json: schema: properties: status: type: boolean example: false message: type: string example: Forbidden data: type: object example: null errors: type: string example: null error_code: type: string example: null type: object '404': description: Transaction not found content: application/json: schema: properties: status: type: boolean example: false message: type: string example: Transaction not found data: type: object example: null errors: type: string example: null error_code: type: string example: null type: object security: - ApiToken: [] components: schemas: V1TransactionResponse: properties: uuid: type: string example: 9c330a70-84de-46c3-a380-70b34799b1d3 payer_uuid: type: string example: 7d021f9a-b5f4-4668-8d78-0f448f55f984 payee_uuid: type: string example: ec82930a-b59e-4ed2-83dd-0f041bfa5baa transaction_status: type: string example: PAYOUT_COMPLETE currency: type: string example: USD amount: type: integer example: 57163 transaction_fee: type: integer example: 0 client_reference_id: type: string example: stageN5@123 payout_delay_days: type: integer example: 0 company_name: type: string example: a-z, A-Z, 12-'3. description: type: string example: null nullable: true addenda: type: string example: null nullable: true type: type: string example: api spped: type: string example: sameday processor_mid: type: string example: '123131123' batch_payout_id: type: string example: 78e84f6a-c36e-4c9e-86bf-6ff4a492be90 capture_status: type: string example: CAPTURE_COMPLETE payout_status: type: string example: PAYOUT_COMPLETE clawback_status: type: string example: null nullable: true reverse_payout_status: type: string example: null nullable: true failure_code: type: string example: null nullable: true failure_reason: type: string example: null nullable: true cancel_reason: type: string example: null nullable: true payer_bank_account: properties: uuid: type: string example: 9c3306a6-743f-4f8f-9a33-dcd081a06204 aggregator_type: type: string example: bank_link type: object payee_bank_account: properties: uuid: type: string example: 9c33090b-c0fb-42ce-9ad8-921665d15a90 aggregator_type: type: string example: bank_link type: object payout_ach_return_code: type: string format: date-time example: R01 payout_failure_reason: type: string format: date-time example: Insufficient funds trace_ids: properties: capture_trace_id: type: string example: ach_92lhg3vbf76qxzp payout_trace_id: type: string example: ach_57ytkdw84mncxvq reverse_payout_trace_id: type: string example: '' refunds: type: array items: properties: refund_uuid: type: string example: '' refund_capture_trace_id: type: string example: '' refund_payout_trace_id: type: string example: '' type: object type: object created_at: type: string format: date-time example: '2024-06-03 15:58:44' updated_at: type: string format: date-time example: '2024-06-04 18:30:30' type: object Error401Unauthorized: properties: status: type: boolean example: false message: type: string example: Invalid Token data: type: string example: null errors: type: string example: null error_code: type: string example: null type: object Error401InvalidTokenStructure: properties: status: type: boolean example: false message: type: string example: >- Invalid token format. The token should be in the following format: ID|TOKEN_VALUE. Example: 12345|abcdefg data: type: string example: null errors: type: string example: null error_code: type: string example: null type: object Error401InvalidTokenData: properties: status: type: boolean example: false message: type: string example: >- Invalid token format. The ID in the token must be an integer. Example: 12345|abcdefg data: type: string example: null errors: type: string example: null error_code: type: string example: null type: object securitySchemes: ApiToken: type: http description: >- Token-based authentication using Authorization: Bearer provided by the GrailPay Support Team. bearerFormat: Token scheme: bearer ````