cURL
curl --request GET --fail-with-body --max-time 30 \
"${AMLOK_API_BASE_URL}/v1/billing/rate-cards?snapshot_id=billing_snapshot_example&limit=100" \
--header "Authorization: Bearer ${AMLOK_API_KEY}" \
--header "Accept: application/json"import os
import requests
base_url = os.environ["AMLOK_API_BASE_URL"].rstrip("/")
headers = {'Accept': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["AMLOK_API_KEY"]
response = requests.request(
"GET", base_url + "/v1/billing/rate-cards?snapshot_id=billing_snapshot_example&limit=100",
headers=headers, timeout=30, allow_redirects=False,
)
response.raise_for_status()
print(response.json())
const baseUrl = process.env.AMLOK_API_BASE_URL;
const apiKey = process.env.AMLOK_API_KEY;
if (!baseUrl || !apiKey) throw new Error("Configure AMLOK_API_BASE_URL and AMLOK_API_KEY");
const headers = {
"Accept": "application/json"
};
headers.Authorization = `Bearer ${apiKey}`;
const response = await fetch(baseUrl.replace(/\/$/, "") + "/v1/billing/rate-cards?snapshot_id=billing_snapshot_example&limit=100", {
method: "GET", headers,
redirect: "error", signal: AbortSignal.timeout(30000),
});
if (!response.ok) throw new Error(`AMLOK returned HTTP ${response.status}`);
console.log(await response.json());{
"data": [
{
"id": "billing_rate_card_example",
"object": "billing_rate_card",
"record_version": 1,
"created_at": "2026-10-23T14:00:00Z",
"updated_at": "2026-10-23T14:00:00Z",
"workspace_id": "wsp_example",
"currency": "CAD",
"effective_from": "2026-10-01T00:00:00Z",
"effective_to": null,
"agreement_id": "agr_example",
"agreement_version": "3",
"supersedes_id": null,
"rates": [
{
"product": "insights",
"tier": "standard",
"unit": "completed_underwriting",
"base_rate": "5.00",
"discount_percent": "0",
"effective_rate": "5.00",
"pricing_basis": "published",
"workload_limits": {
"bank_accounts": 2,
"business_integrations": 5,
"record_limit": 75000,
"minimum_banking_history_months": 12,
"analysis_scope": "Routine reconciliation and standard analysis",
"record_counting_basis": "per_underwriting",
"record_counting_rule": "distinct_record_versions"
},
"billing_timing": "successful_output_completion"
},
{
"product": "insights",
"tier": "advanced",
"unit": "completed_underwriting",
"base_rate": "15.00",
"discount_percent": "0",
"effective_rate": "15.00",
"pricing_basis": "published",
"workload_limits": {
"bank_accounts": 4,
"business_integrations": 10,
"record_limit": 250000,
"minimum_banking_history_months": 12,
"analysis_scope": "Multiple entities or channels and deeper reconciliation",
"record_counting_basis": "per_underwriting",
"record_counting_rule": "distinct_record_versions"
},
"billing_timing": "successful_output_completion"
},
{
"product": "insights",
"tier": "complex",
"unit": "completed_underwriting",
"base_rate": "35.00",
"discount_percent": "0",
"effective_rate": "35.00",
"pricing_basis": "published",
"workload_limits": {
"bank_accounts": 8,
"business_integrations": 20,
"record_limit": 1000000,
"minimum_banking_history_months": 12,
"analysis_scope": "Extensive relationships, exceptions, and investigation",
"record_counting_basis": "per_underwriting",
"record_counting_rule": "distinct_record_versions"
},
"billing_timing": "successful_output_completion"
},
{
"product": "signal",
"tier": "standard",
"unit": "active_account_month",
"base_rate": "3.00",
"discount_percent": "0",
"effective_rate": "3.00",
"pricing_basis": "published",
"workload_limits": {
"bank_accounts": 2,
"business_integrations": 5,
"record_limit": 75000,
"minimum_banking_history_months": null,
"analysis_scope": "Routine reconciliation and standard analysis",
"record_counting_basis": "new_records_per_month",
"record_counting_rule": "distinct_record_versions"
},
"billing_timing": "month_start_or_first_activation"
},
{
"product": "signal",
"tier": "advanced",
"unit": "active_account_month",
"base_rate": "5.00",
"discount_percent": "0",
"effective_rate": "5.00",
"pricing_basis": "published",
"workload_limits": {
"bank_accounts": 4,
"business_integrations": 10,
"record_limit": 250000,
"minimum_banking_history_months": null,
"analysis_scope": "Multiple entities or channels and deeper reconciliation",
"record_counting_basis": "new_records_per_month",
"record_counting_rule": "distinct_record_versions"
},
"billing_timing": "month_start_or_first_activation"
},
{
"product": "signal",
"tier": "complex",
"unit": "active_account_month",
"base_rate": "8.00",
"discount_percent": "0",
"effective_rate": "8.00",
"pricing_basis": "published",
"workload_limits": {
"bank_accounts": 8,
"business_integrations": 20,
"record_limit": 1000000,
"minimum_banking_history_months": null,
"analysis_scope": "Extensive relationships, exceptions, and investigation",
"record_counting_basis": "new_records_per_month",
"record_counting_rule": "distinct_record_versions"
},
"billing_timing": "month_start_or_first_activation"
}
],
"snapshot_id": "billing_snapshot_example"
}
],
"page": {
"has_more": false,
"next_cursor": null,
"limit": 100
},
"meta": {
"request_id": "req_example",
"schema_version": "1.4.2",
"generated_at": "2026-10-23T14:00:00Z",
"data_status": "complete"
}
}
Reporting
List historical rate cards
Read immutable rate-card versions, including published and negotiated rates, workload limits and agreement references. A pricing change creates a new card and supersedes_id; historical usage keeps its original rate_card_id. The singular rate-card route selects the card effective at the snapshot time. effective_to is the exclusive scheduled end, if known when issued; later supersession does not rewrite old cards. Order by effective_from then id. Return only versions known at the selected snapshot.
Required scope: billing:read. The API key is bound to exactly one workspace, institution and environment. There is no workspace override; this binding applies to every read and export.
GET
/
v1
/
billing
/
rate-cards
cURL
curl --request GET --fail-with-body --max-time 30 \
"${AMLOK_API_BASE_URL}/v1/billing/rate-cards?snapshot_id=billing_snapshot_example&limit=100" \
--header "Authorization: Bearer ${AMLOK_API_KEY}" \
--header "Accept: application/json"import os
import requests
base_url = os.environ["AMLOK_API_BASE_URL"].rstrip("/")
headers = {'Accept': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["AMLOK_API_KEY"]
response = requests.request(
"GET", base_url + "/v1/billing/rate-cards?snapshot_id=billing_snapshot_example&limit=100",
headers=headers, timeout=30, allow_redirects=False,
)
response.raise_for_status()
print(response.json())
const baseUrl = process.env.AMLOK_API_BASE_URL;
const apiKey = process.env.AMLOK_API_KEY;
if (!baseUrl || !apiKey) throw new Error("Configure AMLOK_API_BASE_URL and AMLOK_API_KEY");
const headers = {
"Accept": "application/json"
};
headers.Authorization = `Bearer ${apiKey}`;
const response = await fetch(baseUrl.replace(/\/$/, "") + "/v1/billing/rate-cards?snapshot_id=billing_snapshot_example&limit=100", {
method: "GET", headers,
redirect: "error", signal: AbortSignal.timeout(30000),
});
if (!response.ok) throw new Error(`AMLOK returned HTTP ${response.status}`);
console.log(await response.json());{
"data": [
{
"id": "billing_rate_card_example",
"object": "billing_rate_card",
"record_version": 1,
"created_at": "2026-10-23T14:00:00Z",
"updated_at": "2026-10-23T14:00:00Z",
"workspace_id": "wsp_example",
"currency": "CAD",
"effective_from": "2026-10-01T00:00:00Z",
"effective_to": null,
"agreement_id": "agr_example",
"agreement_version": "3",
"supersedes_id": null,
"rates": [
{
"product": "insights",
"tier": "standard",
"unit": "completed_underwriting",
"base_rate": "5.00",
"discount_percent": "0",
"effective_rate": "5.00",
"pricing_basis": "published",
"workload_limits": {
"bank_accounts": 2,
"business_integrations": 5,
"record_limit": 75000,
"minimum_banking_history_months": 12,
"analysis_scope": "Routine reconciliation and standard analysis",
"record_counting_basis": "per_underwriting",
"record_counting_rule": "distinct_record_versions"
},
"billing_timing": "successful_output_completion"
},
{
"product": "insights",
"tier": "advanced",
"unit": "completed_underwriting",
"base_rate": "15.00",
"discount_percent": "0",
"effective_rate": "15.00",
"pricing_basis": "published",
"workload_limits": {
"bank_accounts": 4,
"business_integrations": 10,
"record_limit": 250000,
"minimum_banking_history_months": 12,
"analysis_scope": "Multiple entities or channels and deeper reconciliation",
"record_counting_basis": "per_underwriting",
"record_counting_rule": "distinct_record_versions"
},
"billing_timing": "successful_output_completion"
},
{
"product": "insights",
"tier": "complex",
"unit": "completed_underwriting",
"base_rate": "35.00",
"discount_percent": "0",
"effective_rate": "35.00",
"pricing_basis": "published",
"workload_limits": {
"bank_accounts": 8,
"business_integrations": 20,
"record_limit": 1000000,
"minimum_banking_history_months": 12,
"analysis_scope": "Extensive relationships, exceptions, and investigation",
"record_counting_basis": "per_underwriting",
"record_counting_rule": "distinct_record_versions"
},
"billing_timing": "successful_output_completion"
},
{
"product": "signal",
"tier": "standard",
"unit": "active_account_month",
"base_rate": "3.00",
"discount_percent": "0",
"effective_rate": "3.00",
"pricing_basis": "published",
"workload_limits": {
"bank_accounts": 2,
"business_integrations": 5,
"record_limit": 75000,
"minimum_banking_history_months": null,
"analysis_scope": "Routine reconciliation and standard analysis",
"record_counting_basis": "new_records_per_month",
"record_counting_rule": "distinct_record_versions"
},
"billing_timing": "month_start_or_first_activation"
},
{
"product": "signal",
"tier": "advanced",
"unit": "active_account_month",
"base_rate": "5.00",
"discount_percent": "0",
"effective_rate": "5.00",
"pricing_basis": "published",
"workload_limits": {
"bank_accounts": 4,
"business_integrations": 10,
"record_limit": 250000,
"minimum_banking_history_months": null,
"analysis_scope": "Multiple entities or channels and deeper reconciliation",
"record_counting_basis": "new_records_per_month",
"record_counting_rule": "distinct_record_versions"
},
"billing_timing": "month_start_or_first_activation"
},
{
"product": "signal",
"tier": "complex",
"unit": "active_account_month",
"base_rate": "8.00",
"discount_percent": "0",
"effective_rate": "8.00",
"pricing_basis": "published",
"workload_limits": {
"bank_accounts": 8,
"business_integrations": 20,
"record_limit": 1000000,
"minimum_banking_history_months": null,
"analysis_scope": "Extensive relationships, exceptions, and investigation",
"record_counting_basis": "new_records_per_month",
"record_counting_rule": "distinct_record_versions"
},
"billing_timing": "month_start_or_first_activation"
}
],
"snapshot_id": "billing_snapshot_example"
}
],
"page": {
"has_more": false,
"next_cursor": null,
"limit": 100
},
"meta": {
"request_id": "req_example",
"schema_version": "1.4.2",
"generated_at": "2026-10-23T14:00:00Z",
"data_status": "complete"
}
}
Required scope:
billing:read
Read immutable rate-card versions, including published and negotiated rates, workload limits and agreement references. A pricing change creates a new card and supersedes_id; historical usage keeps its original rate_card_id. The singular rate-card route selects the card effective at the snapshot time. effective_to is the exclusive scheduled end, if known when issued; later supersession does not rewrite old cards. Order by effective_from then id. Return only versions known at the selected snapshot.
Required scope: billing:read. The API key is bound to exactly one workspace, institution and environment. There is no workspace override; this binding applies to every read and export.
Product scope · Processing lifecycle · ErrorsAuthorizations
Server-to-server API key bound to exactly one workspace, institution tenant and environment. No caller-supplied workspace override is accepted. Do not use in public browser code.
Query Parameters
Return the card effective at this UTC instant, no later than the selected snapshot.
Filter by agreement reference.
Reuse an immutable snapshot from this workspace. Omit to use a current snapshot. Cursors bind this value; unknown snapshots return 404 and conflicting cursor parameters return 400.
Page size; default 100, maximum 200.
Required range:
1 <= x <= 200Opaque cursor bound to filters and a stable snapshot.