List Agreements

curl --request GET \
  --url https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/agreements \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/agreements"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/agreements', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/agreements",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/agreements"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/agreements")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/agreements")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "object": "agreement",
      "id": "aagr_2k9m4p7q1w8e5r3t6y0u2i4",
      "title": "Partner Platform Agreement (Non-US)",
      "version": "v1",
      "content_url": "https://docs.platform.example/agreements/partner-platform-agreement-non-us-v1.pdf",
      "status": "pending",
      "responded_at": null,
      "created_at": "2026-06-22T08:30:00Z",
      "updated_at": "2026-06-22T08:30:00Z"
    }
  ],
  "page": 1,
  "size": 64,
  "total": 1,
  "pages": 1
}

GET

ads

customers

{customer_id}

accounts

{account_id}

agreements

List Agreements

curl --request GET \
  --url https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/agreements \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/agreements"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/agreements', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/agreements",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/agreements"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/agreements")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hopnow.io/ads/v1/customers/{customer_id}/accounts/{account_id}/agreements")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "object": "agreement",
      "id": "aagr_2k9m4p7q1w8e5r3t6y0u2i4",
      "title": "Partner Platform Agreement (Non-US)",
      "version": "v1",
      "content_url": "https://docs.platform.example/agreements/partner-platform-agreement-non-us-v1.pdf",
      "status": "pending",
      "responded_at": null,
      "created_at": "2026-06-22T08:30:00Z",
      "updated_at": "2026-06-22T08:30:00Z"
    }
  ],
  "page": 1,
  "size": 64,
  "total": 1,
  "pages": 1
}

Agreements are assigned to an account during onboarding as independent account-scoped actions; they are not part of the automatic KYB submission readiness. The Platform lists the assigned agreements, renders each document (its content_url) to the end customer, and submits an accept or reject action signed by one of the account’s authorized signers.

In v1 agreements are hosted by Hop — there are no third-party signing links. Agreement content and versions are managed by Hop. There is no pre-account “current ToS” endpoint and no signed_agreement_id. Acceptance is recorded through the account-scoped actions endpoint.

Returns the agreements currently assigned to the account. Any agreements not yet assigned are added automatically from the active agreement set for the account’s entity type and country.

Path Parameters

string

required

Identifier of the Platform customer (cus_…). Must be your own customer id.

string

required

Identifier of the Platform end-customer account (acct_…).

Query Parameters

integer

default:"1"

Page number (1-based). Default 1.

integer

default:"64"

Items per page. Default 64; range 1–100.

Response

Returns 200 with a paginated list of assigned agreements.

Agreement objects use created_at / updated_at field names in this response.

object[]

The assigned agreements on this page.

Show agreement attributes

string

Always agreement.

string

Assigned agreement id (aagr_…).

string

Agreement title.

string

Agreement version.

string

URL of the agreement document to render to the end customer.

enum

One of pending, accepted, or rejected.

string

ISO 8601 timestamp of the response; null while pending.

string

ISO 8601 timestamp when the agreement was assigned.

string

ISO 8601 timestamp when the agreement was last updated.

integer

Current page number.

integer

Items per page.

integer

Total number of items.

integer

Total number of pages.

{
  "items": [
    {
      "object": "agreement",
      "id": "aagr_2k9m4p7q1w8e5r3t6y0u2i4",
      "title": "Partner Platform Agreement (Non-US)",
      "version": "v1",
      "content_url": "https://docs.platform.example/agreements/partner-platform-agreement-non-us-v1.pdf",
      "status": "pending",
      "responded_at": null,
      "created_at": "2026-06-22T08:30:00Z",
      "updated_at": "2026-06-22T08:30:00Z"
    }
  ],
  "page": 1,
  "size": 64,
  "total": 1,
  "pages": 1
}

Webhook Events Get Agreement

Getting Started

Integration Flows

Webhooks

Endpoints

List Agreements

Path Parameters

Query Parameters

Response

​Path Parameters

​Query Parameters

​Response

Path Parameters

Query Parameters

Response