---
title: "List merchant-level AgreementRecords the merchant has accepted, in the order they were signed. Excludes per-transaction records (e.g. customer ACH authorizations)."
method: GET
path: "/api/v1/admin/merchants/{id}/agreement-records"
tags: ["Agreement", "Admin"]
---

# List merchant-level AgreementRecords the merchant has accepted, in the order they were signed. Excludes per-transaction records (e.g. customer ACH authorizations).

`GET /api/v1/admin/merchants/{id}/agreement-records`

## Request

- Base URL: `https://core.quidkey.com`
- URL: `https://core.quidkey.com/api/v1/admin/merchants/{id}/agreement-records`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/banqzinc/apis/quidkey-api/docs/api/v1/admin/merchants/:id/agreement-records/get.ts> (a function with typed inputs; its response is checked against the schema)

List merchant-level AgreementRecords the merchant has accepted, in the order they were signed. Excludes per-transaction records (e.g. customer ACH authorizations).

## Path parameters

- `id` string, uuid, required

## Response `200`

Success

- AgreementMerchantAgreementRecordsListResponse
  - `success` boolean, required: Indicates if the request was successful
  - `data` object[], required
    - `id` string, uuid, required: Unique identifier for the agreement record
    - `agreement_id` string, uuid, required: The versioned Agreement this record references
    - `agreement_kind` union, required: The kind of legal agreement
      - 'quidkey_privacy'
      - 'quidkey_tos'
      - 'merchant_tos'
      - 'merchant_dpa'
      - 'merchant_prohibited_use'
      - 'merchant_pricing_plan'
      - 'merchant_bank_debit_authorization'
      - 'merchant_nacha_acknowledgment'
      - 'third_party_provider_agreements'
      - 'transfermate_authorization'
      - 'straddle_psa'
      - 'ach_authorization'
    - `agreement_kind_label` string, required: Human-readable label for the agreement kind
    - `agreement_url_snapshot` string, uri, required: URL the merchant saw at the time of acceptance
    - `accepted_at` string, date-time, required: Timestamp at which the agreement was accepted
    - `evidence_record_id` string, uuid, required: Evidence record that captures the acceptance event

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

## Changes

- **2026-06-17** `b372e7d5563d`: 1 info
  - endpoint added
- **2025-11-02** `919eb7a392aa`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/banqzinc/apis/quidkey-api/changes/api/v1/admin/merchants/:id/agreement-records/get.md)

---

[API](https://skmtc.dev/banqzinc/apis/quidkey-api.md) - [All operations](https://skmtc.dev/banqzinc/apis/quidkey-api/llms.txt) - [OpenAPI document](https://skmtc.dev/banqzinc/apis/quidkey-api/revisions/f86d2bdbcb08?raw)