List agreements

GET /api/v1/partner/customers/{customerId}/agreements

Required scope: agreements:read (global tier).

Returns every catalogued agreement and where this customer stands on each. “Assigned” currently means all customers on the current version. status answers the only question you have: required (no valid acceptance), accepted (current version accepted), or superseded (an old version was accepted and must be re-collected).

Request

curl -X GET https://api.niftipay.com/api/v1/partner/customers/pc-1/agreements \
  -H "Authorization: Bearer <partner_api_key>"

No request body.

Response 200

{
  "request_id": "req-1",
  "api_version": "2026-08-01",
  "data": {
    "agreements": [
      {
        "agreement_id": "tos",
        "title": "Terms of Service",
        "version": "1.0",
        "effective_date": "2026-01-01",
        "document_url": "https://.../tos.pdf",
        "content_hash": "a1b2c3…64hex",
        "parties": [
          {
            "role": "provider",
            "name": "Niftipay"
          },
          {
            "role": "customer",
            "name": "Example SL"
          }
        ],
        "disclosure": "This agreement is between you and Niftipay …",
        "status": "required",
        "current_acceptance": null,
        "previous_acceptances": []
      }
    ]
  }
}

The current_acceptance object mirrors Accept an agreement’s body (sans the wrapping acceptance key).

Errors